Get_Volume_Information

This function returns the Volume_Information_Record for the specified volume.


#include <lvm_intr.h>

Volume_Information_Record _System Get_Volume_Information(

    ADDRESS      Volume_Handle,   /* (I) Handle of the volume to be queried */
    CARDINAL32 * Error_Code       /* (O) Address where the error code will be stored */

);

Parameters

Volume_Handle
The handle of the volume whose information is desired.
Error_Code
The address of a CARDINAL32 in which to store an error code should an error occur.

Returns

A Volume_Information_Record containing information about the specified volume is returned.

Errors

If Volume_Handle is not a valid handle, a trap will be likely. If Volume_Handle is a drive or partition handle, an error condition will occur.

If an error occurs, then any memory allocated by this function will be freed, and the value pointed to by Error_Code will be greater than 0.

Side Effects

None.

Notes

None.

16-Bit Equivalent:

void _Far16 _Pascal _loadds GET_VOLUME_INFORMATION16(
        CARDINAL32                         Volume_Handle,
        Volume_Information_Record * _Seg16 Volume_Information,
        CARDINAL32 *                _Seg16 Error_Code

);