IDiscRecorder2::ReleaseExclusiveAccess 方法 (imapi2.h)

释放对设备的独占访问。

语法

HRESULT ReleaseExclusiveAccess();

返回值

S_OK成功后返回,但其他成功代码可能由于实现而返回。 以下错误代码通常在操作失败时返回,但不表示唯一可能的错误值:

返回代码 说明
E_FAIL
未知故障。

值:0x80004005

E_OUTOFMEMORY
未能分配所需的内存。

值:0x8007000E

E_IMAPI_RECORDER_COMMAND_TIMEOUT
设备未能在超时期限内接受命令。 这可能是由于设备进入了不一致状态,或者可能需要增加命令的超时值。

值:0xC0AA020D

HRESULT_FROM_WIN32 (ERROR_INVALID_HANDLE)
指定的句柄无效。

值:6

HRESULT_FROM_WIN32 (ERROR_DEV_NOT_EXIST)
指定的网络资源或设备不再可用。

值:55

E_IMAPI_RECORDER_LOCKED
上次操作期间与此记录器关联的设备已被独占锁定,导致此操作失败。

值:0xC0AA0210

注解

每个记录器都有锁计数。 第一次调用记录器会锁定设备以便进行独占访问。 应用程序可以多次使用 IDiscRecorder2::AcquireExclusiveAccess 方法在设备上应用多个锁。 每次调用都会将锁计数递增 1。

解锁记录器时,锁定计数必须达到零,以便为其他客户端释放设备。 调用 ReleaseExclusiveAccess 方法会将锁计数递减一。

需要对 AcquireExclusiveAccessReleaseExclusiveAccess 方法进行相等数量的调用才能释放设备。 当锁计数达到零时,录制设备是免费的:删除了最后一个锁。

要求

   
最低受支持的客户端 Windows Vista、Windows XP 和 SP2 [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 [仅限桌面应用]
目标平台 Windows
标头 imapi2.h

另请参阅

IDiscRecorder2

IDiscRecorder2::AcquireExclusiveAccess

IDiscRecorder2::get_ExclusiveAccessOwner