MM_VOLUME_NAMES

Returns list of volume names, whether mounted or not, that the file system is responsible for.

Parameters

Parameters to MM_ObjectControl for this operation are as follows:

objectID
The OBID of the file system application expected to return the list of volume names.
operation
Set to MM_VOLUME_NAMES.
parameter1
Set to zero.
parameter2
Set to zero.
parameter3
Set to zero.
bufferLength
Length, in bytes, of the buffer to receive the volume names.
buffer
A pointer to a VolumeNamesDef structure.

Return Values

The following table lists return values and descriptions.

0x00000000

MM_OK

0x0000020B

MM_BUFFER_TOO_SMALL

This indicates that the buffer was not large enough to receive all of the volume names and that the operation should be called again to get the next set of volume names.

Remarks

These names are placed in a buffer pointed to by the names field in the VolumeNamesDef structure.

The list can contain either ASCII or UNICODE strings, but not both.

Each name in the buffer is separated by an appropriate null character with the last name being terminated by two null characters.

If the given buffer is not large enough to receive all of the volume names, then the file system application will place a value in the token field of the VolumeNamesDef structure to be used on subsequent calls to this operation to get the next set of names. The token should be set, by the application, to -1 on the first call of a series of calls to obtain all of the volume names.