NWMoveFileToDM

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

Local Servers:blocking
Remote Servers:blocking
NetWare Server:4.x, 5.x, 6.x
Platform:NLM, Windows NT, Windows 95, Windows 98
Library:Cross-Platform NetWare Calls (CAL*.*)
Service:Data Migration

Syntax

   #include <nwmigrat.h> 
   or 
   #include <nwcalls.h> 
    
   NWCCODE N_API NWMoveFileToDM ( 
      NWCONN_HANDLE       conn,  
      NWDIR_HANDLE        dirHandle,  
      const nstr8 N_FAR  *path,  
      nuint8              nameSpace,  
      nuint32             supportModuleID,  
      nuint32             saveKeyFlag);
   

Delphi Syntax

   uses calwin32 
    
   Function NWMoveFileToDM 
     (conn : NWCONN_HANDLE; 
      dirHandle : NWDIR_HANDLE; 
      const path : pnstr8; 
      nameSpace : nuint8; 
      supportModuleID : nuint32; 
      saveKeyFlag : nuint32 
   ) : NWCCODE;
   

Parameters

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 path, which points to a directory or file.

nameSpace

(IN) Specifies the name space of the path (see Section 20.5, Name Space Flag Values).

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

These are common return values; see Return Values for C for more information.

0x0000

SUCCESSFUL

0x8801

INVALID_CONNECTION

0x890A

NLM_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

Remarks

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.

NCP Calls

See Also

NWMoveFileFromDM, NWSetDefaultSupportModule, NWGetDMFileInfo