NWGetDMVolumeInfo

Returns information about the Data Migrator NLM 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  NWGetDMVolumeInfo  ( 
      NWCONN_HANDLE   conn,  
      nuint16         volume,  
      nuint32         supportModuleID,  
      pnuint32        numberOfFilesMigrated,  
      pnuint32        totalMigratedSize,  
      pnuint32        spaceUsedOnDM,  
      pnuint32        limboSpaceUsedOnDM,  
      pnuint32        spaceMigrated,  
      pnuint32        filesInLimbo);
   

Delphi Syntax

   uses calwin32 
    
   Function NWGetDMVolumeInfo 
     (conn : NWCONN_HANDLE; 
      volume : nuint16; 
      supportModuleID : nuint32; 
      numberOfFilesMigrated : pnuint32; 
      totalMigratedSize : pnuint32; 
      spaceUsedOnDM : pnuint32; 
      limboSpaceUsedOnDM : pnuint32; 
      spaceMigrated : pnuint32; 
      filesInLimbo : pnuint32 
   ) : NWCCODE;
   

Parameters

conn

(IN) Specifies the NetWare server connection handle.

volume

(IN) Specifies the volume number having the migrated files.

supportModuleID

(IN) Specifies the currently supported module ID.

numberOfFilesMigrated

(OUT) Points to the migrated number of files from the selected volume.

totalMigratedSize

(OUT) Points to the total number of bytes needed to recover all the data on the selected volume.

spaceUsedOnDM

(OUT) Points to the size of the data on the migrator media.

limboSpaceUsedOnDM

(OUT) Points to the size of the demigrated data on the migrator area. Since the data is generally Read Only, the file will be kept on the migrator until the file is either deleted or remigrated with changes.

spaceMigrated

(OUT) Points to the total size of the migrated data for the volume (includes the limbo space used).

filesInLimbo

(OUT) Points to the number of files that are in limbo or were demigrated with SAVE_KEY_WHEN_FILE_IS_DEMIGRATED and have not been migrated back to the data migrator.

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

0x8978

ERR_VOLUME_FLAG_NOT_SET

0x897E

NCP_BOUNDARY_CHECK_FAILED

0x8998

VOLUME_DOES_NOT_EXIST

NCP Calls

See Also

NWGetDefaultSupportModule, NWGetDataMigratorInfo, NWGetSupportModuleInfo