NWGetVolumeName(3nw)


NWGetVolumeName -- returns the name of the volume associated with the specified volume number and NetWare server

Synopsis

   #include <nwvol.h> 
   or 
   #include <nwcalls.h> 
   

NWCCODE N_API NWGetVolumeName (NWCONN_HANDLE conn, nuint16 volNum, pnstr8 volName);

Description

The parameters are as follows:

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

0x0000
SUCCESSFUL

0x8801
INVALID_CONNECTION

0x8996
SERVER_OUT_OF_MEMORY

0x8998
VOLUME_DOES_NOT_EXIST

0x89FF
HARDWARE_FAILURE

Notices

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. Start the scan with volume number 0 and scan upwards until

   volName[0]=="\0" 

indicating the volume is not mounted.

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.

Services

Volume

NCP calls

0x2222 22 6
Get Volume Name

References

NWGetVolumeNumber(3nw)
30 January 1998
© 1998 The Santa Cruz Operation, Inc. All rights reserved.