Returns information about a NetWare volume.
#include <monitor.h>
int netware_vol_info (
struct volume_info *info,
int *sequence);
(OUT) Returns information about a volume.
(IN/OUT) Points to where the volume enumeration should begin. To view information about all volumes, pass zero the first time the function is called and do not modify the returned value on subsequent calls.To return information about a specific volume, set sequence to the volume's number.
If successful, returns 0; otherwise, returns a nonzero error code:
The netware_vol_info function can be used iteratively, so that the information for the next volume is returned each time the function is called. When all possible volumes have been found, the function returns ESRCH.
This function returns information about all defined, mounted volumes.
The sys volume is always volume 0. Normal volume numbers increment from 0 to 255. Clustered volume numbers begin at 255 and then decrement (255, 254, ...).
NOTE:To obtain information not available in the volume_info structure, use Media Manager for NetWare 5.x and 6.x from Storage Architecture Components (including Media Manager and NWPA).
The following example shows how to list the names of the NetWare volumes for the current server. It also is an example of how to use an iterative information call.
#include <stdio.h>
#include <monitor.h>
{
int sequence;
struct volume_info volInfo;
sequence = 0;
while (!netware_vol_info(&volInfo, &sequence))
printf("%02d: %s\n", volInfo.which, volInfo.name);
}