NWGetVolumeNumber

Returns the volume number based on the NetWare server connection handle and the volume name

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) NWGetVolumeNumber ( 
      NWCONN_HANDLE       conn,  
      const nstr8 N_FAR  *volName,  
      pnuint16            volNum); 
   
   

Pascal Syntax

   uses calwin32 
    
   Function NWGetVolumeNumber 
     (conn : NWCONN_HANDLE; 
      const volName : pnstr8; 
      volNum : pnuint16 
   ) : NWCCODE; 
   
   

Parameters

conn
(IN) Specifies the NetWare server connection handle.
volName
(IN) Points to the volume name (17 characters including the terminating NULL).
volNum
(OUT) Points to the volume number (identifies the volume on the NetWare server’s Volume Table).

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

0x8996

SERVER_OUT_OF_MEMORY

0x8998

VOLUME_DOES_NOT_EXIST

Remarks

For sample code, see Developer Q&A.

NCP Calls

See Also

NWGetVolumeName, NWGetVolumeInfoWithNumber