NWGetDMFileInfo

Returns information about data migrated files

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 NWGetDMFileInfo ( 
      NWCONN_HANDLE       conn,  
      NWDIR_HANDLE        dirHandle,  
      const nstr8 N_FAR  *path,  
      nuint8              nameSpace,  
      pnuint32            supportModuleID,  
      pnuint32            restoreTime,  
      pnuint32            dataStreams);
   

Delphi Syntax

   uses calwin32 
    
   Function NWGetDMFileInfo 
     (conn : NWCONN_HANDLE; 
      dirHandle : NWDIR_HANDLE; 
      const path : pnstr8; 
      nameSpace : nuint8; 
      supportModuleID : pnuint32; 
      restoreTime : pnuint32; 
      dataStreams : pnuint32 
   ) : 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 that points to a file.

nameSpace

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

supportModuleID

(OUT) Points to the ID of the Support Module containing the migrated data.

restoreTime

(OUT) Points to an estimate of the time (in ticks) needed to retrieve the data.

dataStreams

(OUT) Points to an array of supported data streams.

Return Values

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

0x0000

SUCCESSFUL

0x00F0

ERR_INVALID_SM_ID

0x8801

INVALID_CONNECTION

0x890A

NLM_INVALID_CONNECTION

0x897E

NCP_BOUNDARY_CHECK_FAILED

0x8998

VOLUME_DOES_NOT_EXIST

0x899B

Bad AFP Entry ID

0x899E

INVALID_FILENAME

0x89A8

ERR_ACCESS_DENIED

0x89BF

INVALID_NAME_SPACE

Remarks

The time returned in the restoreTime parameter represents the estimated number of ticks needed. There are 18.2 ticks in one second.

NCP Calls

See Also

NWGetSupportModuleInfo, NWMoveFileFromDM, NWMoveFileToDM