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 によって定義されます。

その他の成功コードは、実装の結果として返される場合があります。 次のエラー コードは通常、操作の失敗時に返されますが、考えられる唯一のエラー値を表すわけではありません。

リターン コード 説明
E_POINTER
 ポインターが無効です。

値: 0x80004003

解説

列挙体は、呼び出し時にコンピューター上のデバイスのスナップショットであり、追加および削除されたデバイスは反映されません。 デバイスがコンピューターに追加または削除されたときに通知を受信するには、 DDiscMaster2Events インターフェイスを 実装します。

1 つの識別子を取得するには、 IDiscMaster2::get_Item プロパティを 参照してください。

デバイス識別子は、Windows Plug and Playによって認識される特定のデバイスに対して一意かつ静的であることが保証されます。 識別子は、ユーザーの既定のバーナーを保存するためのキー値として使用できます。また、高度なアプリケーションによって他のデバイス固有の静的情報 (VendorID や ProductID など) をキャッシュするために使用することもできます。

要件

   
サポートされている最小のクライアント Windows Vista、WINDOWS XP と SP2 [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム Windows
ヘッダー imapi2.h

関連項目

IDiscMaster2

IDiscMaster2::get_Count