NWGetDMVolumeInfo(3nw)


NWGetDMVolumeInfo -- returns information about the Data Migrator NLM on a NetWare volume

Synopsis

   #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);

Description

The parameters are as follows:

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

0x0000
SUCCESSFUL

0x00F0
ERR_INVALID_SM_ID

0x8801
INVALID_CONNECTION

0x8978
ERR_VOLUME_FLAG_NOT_SET

0x897E
NCP_BOUNDARY_CHECK_FAILED

0x8998
VOLUME_DOES_NOT_EXIST

Services

Data Migration

NCP calls

0x2222 90 130
Get Volume DM Status

References

NWGetDefaultSupportModule(3nw), NWGetDataMigratorInfo(3nw), NWGetSupportModuleInfo(3nw)
30 January 1998
© 1998 The Santa Cruz Operation, Inc. All rights reserved.