NWGetVolumeInfoWithNumber(3nw)
NWGetVolumeInfoWithNumber --
returns volume information
Synopsis
#include <nwvol.h>
or
#include <nwcalls.h>
NWCCODE N_API NWGetVolumeInfoWithNumber
(NWCONN_HANDLE conn,
nuint16 volNum,
pnstr8 volName,
pnuint16 totalBlocks,
pnuint16 sectorsPerBlock,
pnuint16 availableBlocks,
pnuint16 totalDirEntries,
pnuint16 availableDirEntries,
pnuint16 volIsRemovableFlag);
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 (optional 17 character buffer including
the terminating NULL).
- totalBlocks
-
(OUT) Points to the total number of blocks on the volume (optional).
- sectorsPerBlock
-
(OUT) Points to the number of sectors per block (optional).
- availableBlocks
-
(OUT) Points to the number of unused blocks on the volume (optional).
- totalDirEntries
-
(OUT) Points to the total number of physical directory entries (optional).
- availableDirEntries
-
(OUT) Points to the number of unused directory entries (optional).
- volIsRemovableFlag
-
(OUT) Points to a flag indicating whether the volume is removable (optional).
Return values
- 0x0000
-
SUCCESSFUL
- 0x8801
-
INVALID_CONNECTION
- 0x8998
-
VOLUME_DOES_NOT_EXIST
Notices
NWGetDirSpaceInfo should be called to return information on
volumes whose size is greater than 256 megabytes.
volNum identifies the volume name on the NetWare server's
Volume Table.
Volumes use logical sector sizes of 512 bytes. If the physical media
uses a different sector size, the server performs appropriate mappings.
Volume space is allocated in groups of sectors called blocks.
sectorsPerBlock indicates the number of 512-byte sectors
contained in each block of the specified volume.
totalDirEntries indicates how many directory entries were
allocated for the specified volume during installation. If this
information is meaningless under a given server's implementation, it
is 0xFFFF.
volIsRemovableFlag indicates whether a user can physically
remove the volume from the NetWare server. It returns one of the
following values:
- 0x0000
-
not removable/fixed media
- non-zero
-
removable/mountable
Since all of the output parameters are optional, substitute a
NULL for unwanted information. However, all parameter
positions must be filled.
With NetWare 4.x and SFTIII, the volume srctor size can be
changed from the 512-byte default. If changed,
NWGetVolumeInfoWithHandlemay return adjusted data that meets
DOS requirements. totalBlocks, sectorsPerBlock,
and availableBlocks may be affected. To see the actual field
size, call NWGetExtendedVolumeInfo.
NOTE:
Block size can be found by calling NWGetExtendedVolumeInfo
and multiplying sectorSize and sectorPerCluster.
Services
Volume
NCP calls
- 0x2222 18
-
Get Volume Info With Number
References
NWGetDirSpaceInfo(3nw),
NWGetVolumeInfoWithHandle(3nw)
30 January 1998
© 1998 The Santa Cruz Operation, Inc. All rights reserved.