IDiscRecorder::OpenExclusive 方法 (imapi.h)
打开光盘录制器进行独占访问。
语法
HRESULT OpenExclusive();
返回值
成功后返回S_OK,但实现后可能会返回其他成功代码。 以下错误代码通常在操作失败时返回,但不表示唯一可能的错误值:
注解
此方法阻止文件系统通过资源管理器等应用程序访问记录器。 必须先使用此方法打开记录器,然后才能使用以下方法: QueryMediaType、 弹出、 Erase 和 Close。
请务必在调用 IDiscMaster::RecordDisc 之前关闭记录器,否则它将失败并IMAPI_E_DEVICE_NOTACCESSIBLE。 设备专门承诺通过 IDiscRecorder 或 IDiscMaster 进行访问,但不能同时访问两者。 这是为了确保在应用程序控制或刻录期间,不会混淆录制器允许的操作和所有权。
独占锁的保留时间应尽可能短。 来自其他操作系统组件的请求不会排队等待以后执行。 相反,它们只是失败了。 这可能会导致用户感到困惑,因为用户认为没有正在进行烧伤。
每当调用 OpenExclusive 时,它都会向文件系统显示光盘已被删除。 进行相应的 Close 调用时,媒体重新出现的文件系统会显示该调用。 这可能会导致自动运行问题。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows XP [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2003 [仅限桌面应用] |
目标平台 | Windows |
标头 | imapi.h |
Library | Uuid.lib |
DLL | Actxprxy.dll |