MM_POOL_GET_INFO

Returns information on a pool (see Pools).

Version:NetWare 6.x

Parameters

Parameters to MM_ObjectControl for this operation are as follows:

objectID
The OBID of the file system application to return the pool information.
operation
Set to MM_POOL_GET_INFO.
parameter1
Set to zero.
parameter2
Set to zero.
parameter3
Set to zero.
bufferLength
The size, in bytes, of the VolumeInfoDef structure.
buffer
A pointer to a VolumeInfoDef structure. The volumeName element must contain a valid pool name.

Return Values

The following table lists return values and descriptions.

0x00000000

MM_OK

0x00000008

MM_OBJECT_NOT_FOUND

The file system cannot identify the pool, by the given name, as one under the file system’s responsibility.

Remarks

This information is returned in the form of a VolumeInfoDef. Within this structure is a pointer to a VolumeConfigElementList structure allocated by the file system application. (See the MM_VOLUME_RETURN_CONFIG_DIALOG operation.)

An application can present this information to a user for modification. Only those fields in the VolumeConfigElementList structure defined as modifiable, however, can be modified. The token in the VolumeConfigElementList structure must be returned to the file system application by the operations MM_VOLUME_CHANGE_INFO or MM_VOLUME_RETURN_TOKEN.