Get_Available_Drive_Letters

#include <lvm_intr.h>

CARDINAL32 _System Get_Available_Drive_Letters(

    CARDINAL32 * Error_Code   /* (O) Address where the error code will be stored */

);

Parameters

Error_Code

The address of a CARDINAL32 in which to store an error code should an error occur.

Returns

This function returns a bitmap of the available drive letters.

Drive letters 'A' through 'Z' are represented in the bitmap from right to left. In other words, 'A' is 0x00000001 and 'Z' is 0x02000000.

Errors

If an error occurs, the value pointed to by Error_Code will be > 0, and the returned bitmap will have all bits set to 0.

Side Effects

None.

Notes

A drive letter is available if it is not associated with a volume located on a disk drive controlled by OS2DASD. This includes drive letters which are currently assigned to non-LVM devices, such as CD-ROM and network drives.

You can use the Get_Reserved_Drive_Letters function to determine which drive letters are currently in use by non-LVM devices.

16-Bit Equivalent:

CARDINAL32 _Far16 _Pascal _loadds GET_AVAILABLE_DRIVE_LETTERS16( CARDINAL32 * _Seg16 Error_Code );