NWGetVolumeInfoWithNumber(3nw)


NWGetVolumeInfoWithNumber -- returns volume information

Synopsis

   #include <nwvol.h> 
   or 
   #include <nwcalls.h> 
   

NWCCODE N_API NWGetVolumeInfoWithNumber (NWCONN_HANDLE conn, nuint16 volNum, pnstr8 volName, pnuint16 totalBlocks, pnuint16 sectorsPerBlock, pnuint16 availableBlocks, pnuint16 totalDirEntries, pnuint16 availableDirEntries, pnuint16 volIsRemovableFlag);

Description

The parameters are as follows:

conn
(IN) Specifies the NetWare server connection handle.

volNum
(IN) Specifies the volume number of the volume for which information is being obtained.

volName
(OUT) Points to the volume name (optional 17 character buffer including the terminating NULL).

totalBlocks
(OUT) Points to the total number of blocks on the volume (optional).

sectorsPerBlock
(OUT) Points to the number of sectors per block (optional).

availableBlocks
(OUT) Points to the number of unused blocks on the volume (optional).

totalDirEntries
(OUT) Points to the total number of physical directory entries (optional).

availableDirEntries
(OUT) Points to the number of unused directory entries (optional).

volIsRemovableFlag
(OUT) Points to a flag indicating whether the volume is removable (optional).

Return values

0x0000
SUCCESSFUL

0x8801
INVALID_CONNECTION

0x8998
VOLUME_DOES_NOT_EXIST

Notices

NWGetDirSpaceInfo should be called to return information on volumes whose size is greater than 256 megabytes.

volNum identifies the volume name on the NetWare server's Volume Table.

Volumes use logical sector sizes of 512 bytes. If the physical media uses a different sector size, the server performs appropriate mappings. Volume space is allocated in groups of sectors called blocks.

sectorsPerBlock indicates the number of 512-byte sectors contained in each block of the specified volume.

totalDirEntries indicates how many directory entries were allocated for the specified volume during installation. If this information is meaningless under a given server's implementation, it is 0xFFFF.

volIsRemovableFlag indicates whether a user can physically remove the volume from the NetWare server. It returns one of the following values:

0x0000
not removable/fixed media

non-zero
removable/mountable
Since all of the output parameters are optional, substitute a NULL for unwanted information. However, all parameter positions must be filled.

With NetWare 4.x and SFTIII, the volume srctor size can be changed from the 512-byte default. If changed, NWGetVolumeInfoWithHandlemay return adjusted data that meets DOS requirements. totalBlocks, sectorsPerBlock, and availableBlocks may be affected. To see the actual field size, call NWGetExtendedVolumeInfo.


NOTE: Block size can be found by calling NWGetExtendedVolumeInfo and multiplying sectorSize and sectorPerCluster.

Services

Volume

NCP calls

0x2222 18
Get Volume Info With Number

References

NWGetDirSpaceInfo(3nw), NWGetVolumeInfoWithHandle(3nw)
30 January 1998
© 1998 The Santa Cruz Operation, Inc. All rights reserved.