Skip to main content

DriverBlock

Block or unblock a drive mounted at given path, or block/unblock all connected drives if path is not supplied. Note that all processes that blocked the drive must unblock it before it becomes accessible again. System drive cannot be blocked. Requires administrative privileges.

Syntax​

Method ID​

#define WAAPI_MID_DRIVER_BLOCK 29015

JSON Input Structure​

{
"input": {
"method": 29015,
"enable": boolean,
"path": string
}
}

Input Properties​

ParameterTypeDescription
enablebooleanTrue if drive should be blocked, false if it should be unblocked.
pathstringPath where the drive is mounted, or leave out this key if blocking all currently connected drives.

JSON Output Structure​

{
"result": {
"method": 29015,
"code": number,
"timing": number,
"timestamp": string
}
}

Output Properties​

PropertyTypeDescription
result.methodnumberThe method ID that generated this result.
result.codenumberThe result code. See Result Codes.
result.timingnumberThe measured time for the method call in milliseconds.
result.timestampstringThe timestamp in seconds of when the call was made.

Result Codes​

CodeNameDescription
0WAAPI_OKThe operation completed successfully.
note

Other codes may be returned. See the full Result Codes reference for the complete list.

Remarks​

Error Handling​

The results of this function are determined by the error code returned by the call. If successful, WAAPI_OK or a special success code will be returned. Always check both the function return value and the result.code field in the output JSON.

Examples​

Examples will be added here demonstrating the usage of this method.

See Also​


Last updated: 2026-10-01