Get Volume Information 0x2222 23 233

Returns information about a specified volume.

NetWare Servers:2.x

Request Format

Offset

Content

Type

Request header

6

FunctionCode (23)

byte

7

SubFuncStrucLen (2)

word (Hi-Lo)

9

SubFunctionCode (233)

byte

10

VolumeNumber

byte

Reply Format

Offset

Content

Type

Reply header

8

SystemIntervalMarker

long

12

VolumeNumber

byte

13

LogicalDriveNumber

byte

14

BlockSize

word

16

StartingBlock

word

18

TotalBlocks

word

20

FreeBlocks

word

22

TotalDirectoryEntries

word

24

FreeDirectoryEntries

word

26

ActualMaxUsedDirectoryEntries

word

28

VolumeHashedFlag

byte

29

VolumeCachedFlag

byte

30

VolumeRemovableFlag

byte

31

VolumeMountedFlag

byte

32

VolumeName

byte[16]

Parameters

SystemIntervalMarker

(Reply) Specifies the length of time the server has been up.

VolumeNumber

(Reply) Specifies the volume in a volume table on the file server.

LogicalDriveNumber

(Reply) Specifies the logical drive number of the drive on which the volume exists.

BlockSize

(Reply) Specifies the number of 512-byte sectors that are contained in each block of the specified volume.

StartingBlock

(Reply) Specifies the number of the volume's first block.

TotalBlocks

(Reply) Specifies the total number of blocks in the specified volume.

FreeBlocks

(Reply) Specifies the total number of unused blocks in the specified volume.

TotalDirectoryEntries

(Reply) Specifies the number of directory slots that are allocated for the specified volume.

FreeDirectoryEntries

(Reply) Specifies the number of unused directory slots.

ActualMaxUsedDirectoryEntries

(Reply) Specifies the most directory slots that were simultaneously used on the volume.

VolumeHashedFlag

(Reply) Specifies whether the volume is hashed in file server memory:

  • 0 Not hashed
VolumeCacheFlag

(Reply) Specifies whether the volume is cached in file server memory:

  • 0 Volume not cached
VolumeRemovableFlag

(Reply) Specifies whether the volume is physically mounted in the file server:

  • 0 Volume is not mounted
VolumeName

(Reply) Specifies the name given to the volume (from 1 to 16 characters).

Return Values

Decimal

Hex

Description

0

0x00

Successful

150

0x96

Server Out Of Memory

152

0x98

Disk Map Error

198

0xC6

No Console Rights

Remarks

You must have console operator privileges to call Get Volume Information.

SystemIntervalMarker is returned in units of approximately 1/18 of a second and is used to determine the amount of time that has elapsed between consecutive requests. (There are 18.2 ticks per second, or one tick every 0.54945054 of a second). When this parameter reaches 0xFFFFFFFF, it wraps back to zero.

The volume table contains information about each volume on the file server. A file server running NetWare 2.1 and above can accommodate up to 32 volumes (0...31).

VolumeName cannot contain spaces or the characters: *, ?, :, /, or \. If it less than 16 characters long, the remaining characters must be NULL.