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.