iDiscMaster2::get__NewEnum 方法 (imapi2.h)
检索计算机上安装的 CD 和 DVD 设备的列表。
语法
HRESULT get__NewEnum(
[out] IEnumVARIANT **ppunk
);
parameters
[out] ppunk
一个 IEnumVariant 接口,用于枚举计算机上安装的 CD 和 DVD 设备。 枚举的项是类型为 VT_BSTR的变体。 使用 bstrVal 成员检索设备的唯一标识符。
返回值
如果成功返回请求的元素数 (celt) ,或者 (pceltFetched) 返回的项数小于请求的元素数,则返回S_OK。 celt 和 pceltFetched 参数由 IEnumVariant 定义。
其他成功代码可能会作为实现的结果返回。 以下错误代码通常在操作失败时返回,但不表示唯一可能的错误值:
返回代码 | 说明 |
---|---|
|
指针无效。
值:0x80004003 |
注解
枚举是调用时计算机上的设备的快照,不会反映添加和删除的设备。 若要在计算机中添加或删除设备时接收通知,请实现 DDiscMaster2Events 接口。
若要检索单个标识符,请参阅 IDiscMaster2::get_Item 属性。
对于 Windows 即插即用识别的给定设备,设备标识符保证是唯一且静态的。 可以将标识符用作保存用户默认燃烧器的键值,还可用于缓存其他特定于设备的静态信息, (例如,高级应用程序) VendorID 和 ProductID。
要求
最低受支持的客户端 | Windows Vista、Windows XP SP2 [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2003 [仅限桌面应用] |
目标平台 | Windows |
标头 | imapi2.h |