IDiscRecorder2::get_ExclusiveAccessOwner method (imapi2.h)

Article
02/22/2024

Retrieves the name of the client application that has exclusive access to the device.

Syntax

HRESULT get_ExclusiveAccessOwner(
  [in] BSTR *value
);

Parameters

[in] value

String that contains the name of the client application that has exclusive access to the device.

Return value

S_OK is returned on success, but other success codes may be returned as a result of implementation. The following error codes are commonly returned on operation failure, but do not represent the only possible error values:

Return code	Description
E_POINTER	Pointer is not valid. Value: 0x80004003
E_FAIL	Unspecified failure. Value: 0x80004005
E_OUTOFMEMORY	Failed to allocate the required memory. Value: 0x8007000E
E_IMAPI_RECORDER_COMMAND_TIMEOUT	The device failed to accept the command within the timeout period. This may be caused by the device having entered an inconsistent state, or the timeout value for the command may need to be increased. Value: 0xC0AA020D
HRESULT_FROM_WIN32(ERROR_INVALID_HANDLE)	The specified handle is invalid. Value: 6
HRESULT_FROM_WIN32(ERROR_DEV_NOT_EXIST)	The specified network resource or device is no longer available. Value: 55
E_IMAPI_RECORDER_LOCKED	The device associated with this recorder during the last operation has been exclusively locked, causing this operation to fail. Value: 0xC0AA0210

Remarks

This property returns the current exclusive access owner of the device. This value comes directly from CDROM.SYS and should be queried anytime an operation fails with error E_IMAPI_RECORDER_LOCKED.

Requirements

Requirement	Value
Minimum supported client	Windows Vista, Windows XP with SP2 [desktop apps only]
Minimum supported server	Windows Server 2003 [desktop apps only]
Target Platform	Windows
Header	imapi2.h