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。 celtpceltFetched 参数由 IEnumVariant 定义。

其他成功代码可能会作为实现的结果返回。 以下错误代码通常在操作失败时返回,但不表示唯一可能的错误值:

返回代码 说明
E_POINTER
指针无效。

值:0x80004003

注解

枚举是调用时计算机上的设备的快照,不会反映添加和删除的设备。 若要在计算机中添加或删除设备时接收通知,请实现 DDiscMaster2Events 接口。

若要检索单个标识符,请参阅 IDiscMaster2::get_Item 属性。

对于 Windows 即插即用识别的给定设备,设备标识符保证是唯一且静态的。 可以将标识符用作保存用户默认燃烧器的键值,还可用于缓存其他特定于设备的静态信息, (例如,高级应用程序) VendorID 和 ProductID。

要求

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

另请参阅

IDiscMaster2

IDiscMaster2::get_Count