Hide_Volume

This function 'hides' a volume from OS/2 by removing its drive letter assignment. Without a drive letter assignment, OS/2 can not access the volume.


#include <lvm_intr.h>

void _System Hide_Volume(

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

);

Parameters

Volume_Handle: The handle of the volume which is to be hidden.
Error_Code: The address of a CARDINAL32 in which to store an error code should an error occur.

Returns

N/A.

Errors

If Volume_Handle is not a valid handle, a trap may result.

If Volume_Handle is a partition or drive handle, then this function will abort and the value pointed to by Error_Code will be non-zero.

If the volume cannot be hidden, then nothing will be altered and an error condition will occur.

In the event of an error, the value pointed to by Error_Code will be greater than 0.

Side Effects

None.

Notes

None.

16-Bit Equivalent:

void _Far16 _Pascal _loadds HIDE_VOLUME16(
        CARDINAL32          Volume_Handle,
        CARDINAL32 * _Seg16 Error_Code
);