NWGetVolumeInfoByLevel

Returns information about the specified volume, returning different structures depending on the infoLevel specified.

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:Server Environment

Syntax

  #include <nwfse.h> 
  or 
  #include <nwcalls.h> 
   
  NWCCODE N_API  NWGetVolumeInfoByLevel  ( 
     NWCONN_HANDLE                        conn,  
     nuint32                              volNum,  
     nuint32                              infoLevel,  
     NWFSE_VOLUME_INFO_BY_LEVEL  N_FAR   *fseVolumeInfo);
  

Delphi Syntax

  uses calwin32 
   
  Function NWGetVolumeInfoByLevel 
    (conn : NWCONN_HANDLE; 
     volNum : nuint32; 
     infoLevel : nuint32; 
     Var fseVolumeInfo : NWFSE_VOLUME_INFO_BY_LEVEL 
  ) : NWCCODE;
  

Parameters

conn
(IN) Specifies the NetWare server connection handle.
volNum
(IN) Specifies the volume number for which information is being obtained.
infoLevel
(IN) Specifies which level of information to return (1 or 2).
fseVolumeInfo
(OUT) Points to NWFSE_VOLUME_INFO_BY_LEVEL containing the information.

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

0x897E

NCP_BOUNDARY_CHECK_FAILED

0x8998

VOLUME_DOES_NOT_EXIST

0x89FF

Failure

Remarks

Console operator rights are NOT necessary to call NWGetVolumeInfoByLevel.

NCP Calls

See Also

NWGetVolumeInfoWithHandle, NWGetVolumeInfoWithNumber (Volume Management)