NWGetVolumeName

Returns the name of the volume associated with the specified volume number and NetWare server

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 ) NWGetVolumeName  ( 
      NWCONN_HANDLE   conn,  
      nuint16         volNum,  
      pnstr8          volName);

Pascal Syntax

   uses calwin32 
    
   Function NWGetVolumeName 
     (conn : NWCONN_HANDLE; 
      volNum : nuint16; 
      volName : pnstr8 
   ) : 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 (17 characters including the terminating NULL).

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

0x89FF

HARDWARE_FAILURE

Remarks

volNum identifies the volume name on the NetWare server’s Volume Table. volNum needs to be between 0 and the maximum allowable volumes on the server.

NWGetVolumeName can be called to determine all volume numbers and volume names currently mounted on the specified NetWare server:

  • For regular volumes, start the scan with volume number 0 and scan upwards.
  • For clustered volumes, start the scan with volume number 255 and scan downwards.

SUCCESSFUL will be returned for each allowable volume number whether or not that volume exists on the specified server. For example, NetWare 3.x and above supports 64 volumes on each server. Calling NWGetVolumeName on each of the 64 volumes will return SUCCESSFUL even though the volume is not mounted.

NCP Calls

See Also

NWGetVolumeNumber