NWGetVolumeInfoWithNumber

Returns information for the specified volume by passing a volume number, allowing a client to check the physical space available on a volume

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

Syntax

   #include <nwvol.h> 
   or 
   #include <nwcalls.h> 
    
   N_EXTERN_LIBRARY( NWCCODE ) NWGetVolumeInfoWithNumber  ( 
      NWCONN_HANDLE   conn,  
      nuint16         volNum,  
      pnstr8          volName,  
      pnuint16        totalBlocks,  
      pnuint16        sectorsPerBlock,  
      pnuint16        availableBlocks,  
      pnuint16        totalDirEntries,  
      pnuint16        availableDirEntries,  
      pnuint16        volIsRemovableFlag);

Pascal Syntax

   uses calwin32 
    
   Function NWGetVolumeInfoWithNumber
     (conn : NWCONN_HANDLE; 
      volNum : nuint16; 
      volName : pnstr8; 
      totalBlocks : pnuint16; 
      sectorsPerBlock : pnuint16; 
      availableBlocks : pnuint16; 
      totalDirEntries : pnuint16; 
      availableDirEntries : pnuint16; 
      volIsRemovableFlag : pnuint16 
   ) : NWCCODE;

Parameters

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) Set to NULL. The value in this field is never set.

Return Values

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

0x0000

SUCCESSFUL

0x8801

INVALID_CONNECTION

0x890A

NLM_INVALID_CONNECTION

0x8998

VOLUME_DOES_NOT_EXIST

Remarks

NWGetVolumeInfoWithNumber returns a 16-bit number in the totalBlocks parameter. If the volume size is greater than a 16-bit number (or 256 megabytes), NWGetDirSpaceInfo should be called.

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.

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, 5.x, 6.x, and SFTIII, the volume sector size can be changed from the 512-byte default. If changed, NWGetVolumeInfoWithHandle may 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.

NCP Calls

See Also

NWGetDirSpaceInfo (Multiple and Inter-File Services), NWGetVolumeInfoWithHandle