IDiscMaster2::get__NewEnum 方法 (imapi2.h)
擷取電腦上安裝的 CD 和 DVD 裝置清單。
語法
HRESULT get__NewEnum(
[out] IEnumVARIANT **ppunk
);
參數
[out] ppunk
您用來列舉電腦上安裝的 CD 和 DVD 裝置的 IEnumVariant 介面。 列舉的專案是類型 為VT_BSTR的變體。 使用 bstrVal 成員來擷取裝置的唯一識別碼。
傳回值
S_OK傳回要求的專案數目時, (celt) 成功傳回,或 (pceltFetched) 傳回的專案數小於要求的元素數目。 celt和pceltFetched參數是由IEnumVariant所定義。
其他成功碼可能會因為實作而傳回。 下列錯誤碼通常會在作業失敗時傳回,但不代表唯一可能的錯誤值:
傳回碼 | 描述 |
---|---|
|
指標無效。
值:0x80004003 |
備註
列舉是呼叫時電腦上裝置的快照集,不會反映新增和移除的裝置。 若要在電腦新增或移除裝置時接收通知,請實作 DDiscMaster2Events 介面。
若要擷取單一識別碼,請參閱 IDiscMaster2::get_Item 屬性。
裝置識別碼保證為 Windows 隨插即用所辨識的指定裝置是唯一且靜態的。 您可以使用識別碼做為索引鍵值來儲存使用者的預設火器,也可以用來快取其他裝置特定的靜態資訊 (,例如,進階應用程式的 VendorID 和 ProductID) 。
需求
最低支援的用戶端 | Windows Vista、Windows XP 與 SP2 [僅限傳統型應用程式] |
最低支援的伺服器 | Windows Server 2003 [僅限傳統型應用程式] |
目標平台 | Windows |
標頭 | imapi2.h |