NWMoveFileToDM(3nw)


NWMoveFileToDM -- moves file data to an online, long term storage medium but leaves the file visible on a NetWare volume

Synopsis

   #include <nwmigrat.h> 
   or 
   #include <nwcalls.h> 
   

NWCCODE N_API NWMoveFileToDM (NWCONN_HANDLE conn, NWDIR_HANDLE dirHandle, pnstr8 path, nuint8 nameSpace, nuint32 supportModuleID, nuint32 saveKeyFlag);

Description

The parameters are as follows:

conn
(IN) Specifies the NetWare server connection handle.

dirHandle
(IN) Specifies the directory handle associated with the desired name space (optional).

path
(IN) Points to a valid DOS path (pointing to a directory or file).

nameSpace
(IN) Specifies the name space of the DOS path.

supportModuleID
(IN) Specifies the assigned ID number of the support module migrating the data.

saveKeyFlag
(IN) Specifies if the migrator key will be saved when the file is demigrated: 0 = migrator key will not be saved, 1 = migrator key will be saved.

Return values

0x0000
SUCCESSFUL

0x8801
INVALID_CONNECTION

0x897E
NCP_BOUNDARY_CHECK_FAILED

0x8996
SERVER_OUT_OF_MEMORY

0x8998
VOLUME_DOES_NOT_EXIST

0x899B
BAD_DIRECTORY_HANDLE

0x899E
INVALID_FILENAME

0x899C
INVALID_PATH

0x89A8
ERR_ACCESS_DENIED

0x89FB
Invalid Namespace

Notices

If saveKeyFlag equals SAVE_KEY_WHEN_FILE_IS_DEMIGRATED, the key will be saved when the file is demigrated. This saves time because the file will not be deleted from the migrated media and will be checked for changes before subsequent migrations.

Services

Data Migration

NCP calls

0x2222 87 06
Obtain File or Subdirectory Information

0x2222 90 128
Move File Data To DM

References

NWMoveFileFromDM(3nw), NWSetDefaultSupportModule(3nw), NWGetDMFileInfo(3nw)
30 January 1998
© 1998 The Santa Cruz Operation, Inc. All rights reserved.