IDiscRecorder2::ReleaseExclusiveAccess method (imapi2.h)
Releases exclusive access to the device.
Syntax
HRESULT ReleaseExclusiveAccess();
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 |
|---|---|
|
Unspecified failure.
Value: 0x80004005 |
|
Failed to allocate the required memory.
Value: 0x8007000E |
|
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 |
|
The specified handle is invalid.
Value: 6 |
|
The specified network resource or device is no longer available.
Value: 55 |
|
The device associated with this recorder during the last operation has been exclusively locked, causing this operation to failed.
Value: 0xC0AA0210 |
Remarks
Each recorder has a lock count. The first call to a recorder locks the device for exclusive access. Applications can use the IDiscRecorder2::AcquireExclusiveAccess method multiple times to apply multiple locks on a device. Each call increments the lock count by one.
When unlocking a recorder, the lock count must reach zero to free the device for other clients. Calling the ReleaseExclusiveAccess method decrements the lock count by one.
An equal number of calls to the AcquireExclusiveAccess and ReleaseExclusiveAccess methods are needed to free a device. When the lock count reaches zero, recording device is free; the last lock has been removed.
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 |