NWGetExtendedVolumeInfo

Returns extended volume information

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:Volume

Syntax

   #include <nwvol.h> 
   or 
   #include <nwcalls.h> 
    
   N_EXTERN_LIBRARY( NWCCODE ) NWGetExtendedVolumeInfo  ( 
      NWCONN_HANDLE              conn,  
      nuint16                    volNum,  
      NWVolExtendedInfo N_FAR   *volInfo);

Pascal Syntax

   uses calwin32 
    
   Function NWGetExtendedVolumeInfo 
     (conn : NWCONN_HANDLE; 
      volNum : nuint16; 
      Var volInfo : NWVolExtendedInfo 
   ) : NWCCODE;

Parameters

conn
(IN) Specifies the NetWare server connection handle.
volNum
(IN) Specifies the volume number.
volInfo
(OUT) Points to NWVolExtendedInfo, which receives information.

Return Values

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

0x0000

SUCCESSFUL

0x8998

VOLUME_DOES_NOT_EXIST

0x897E

NCP_BOUNDARY_CHECK_FAILED

0x89FB

NO_SUCH_PROPERTY

Remarks

NWGetExtendedVolumeInfo returns information based on the volume block size (64 KB), which can be determined using the formula:

   (sectorSize*sectorsPerCluster)/1024

NWGetExtendedVolumeInfo must be called for a licensed connection or NO_SUCH_PROPERTY will be returned.

For sample code, see Developer Q&A.

NCP Calls