# Function Reference

# _WinAPI_LockDevice

Enables or disables the mechanism that ejects media, for those devices possessing that locking capability

#include <WinAPIFiles.au3>
_WinAPI_LockDevice ( $sDrive, $bLock )

## Parameters

$sDrive | The drive letter of the device to enable or disable, in the format D:, E:, etc.
$bLock | Specifies whether the device should be disabled, valid values: True - The device is disabled. False - The device is enabled.

## Return Value

Success: | True.
Failure: | False and sets the @error flag to non-zero.

## Remarks

This function is valid only for devices that support removable media.

## See Also

Search IOCTL_STORAGE_MEDIA_REMOVAL in MSDN Library.

## Example

    #include <MsgBoxConstants.au3>
    #include <WinAPIFiles.au3>

    Local $aDrive = DriveGetDrive('CDROM')

    If IsArray($aDrive) Then
        _WinAPI_LockDevice($aDrive[1], 1)
        MsgBox($MB_SYSTEMMODAL, '', 'The drive (' & StringUpper($aDrive[1]) & ') is locked.')
        _WinAPI_LockDevice($aDrive[1], 0)
        MsgBox($MB_SYSTEMMODAL, '', 'The drive (' & StringUpper($aDrive[1]) & ') is unlocked.')
    EndIf