MM_POOL_RETURN_MAPPING

Returns the logical partition associated with 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 mapping information.
operation
Set to MM_POOL_RETURN_MAPPING.
parameter1
Set to zero.
parameter2
Set to zero.
parameter3
Set to zero.
bufferLength
The number of elements in the VolumeMappingElementDef structures array that the application has made available.
buffer
A pointer to a VolumeMappingInfo structure.

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.

0x0000020B

MM_BUFFER_TOO_SMALL

The number of provided array elements was not enough to receive all of the VolumeMappingElementDef structures. If this return value is returned, the file system application will place a value in the numberOfElements field of the VolumeMappingInfo structure indicating the actual number of segments that make up the volume. The calling application then knows how many array elements are required and can retry this operation with the proper adjustments made.

Remarks

If the pool consists of multiple elements, MM_POOL_RETURN_MAPPING returns the list of all the elements that go into the pool.

NOTE:If the pool contains multiple elements, none of these elements is the logical partition associated with the pool. There is one child object that all of these elements point to that is the logical partition for the pool.

The calling application must provide the space for the information returned by the file system application.

bufferlength
The number of elements the buffer can hold.
buffer
Pointer to a structure of VolumeMappingInfo.

The file system application places into the provided array space a set of VolumeMappingElementDef structures that define the partitions segments that make up the capacity of the pool.