IWiaItem2::EnumChildItems メソッド
列挙子オブジェクトを作成し、Windows イメージ取得 (WIA) 2.0 デバイスの IWiaItem2 ツリー内の項目を含むフォルダーの IEnumWiaItem2 インターフェイスへのポインターを返します。
構文
HRESULT EnumChildItems(
[in] const GUID *pCategoryGUID,
[out] IEnumWiaItem2 **ppIEnumWiaItem2
);
パラメーター
-
pCategoryGUID [in]
-
型: const GUID*
子ノードを列挙するカテゴリへのポインターを指定します。 NULL の場合、すべての子ノードが列挙されます。
-
ppIEnumWiaItem2 [out]
-
種類: IEnumWiaItem2**
このメソッドによって作成される IEnumWiaItem2 インターフェイスへのポインターのアドレスを受け取ります。
戻り値
型: HRESULT
このメソッドが成功すると、 S_OKが返されます。 それ以外の場合は、 HRESULT エラー コードが返されます。
注釈
WIA 2.0 ランタイム システムは、各 WIA 2.0 ハードウェア デバイスを IWiaItem2 オブジェクトの階層ツリーとして表します。 IWiaItem2::EnumChildItems メソッドを使用すると、アプリケーションは現在のアイテム内の子項目を列挙できます。 ただし、フォルダーであるアイテムにのみ適用できます。
フォルダーが空でない場合は、 IWiaItem2 オブジェクトのサブツリーが含まれます。 IWiaItem2::EnumChildItems メソッドは、フォルダーに含まれるすべてのアイテムを列挙します。 列挙子へのポインターを ppIEnumWiaItem2 パラメーターに格納します。 アプリケーションでは、列挙子ポインターを使用して、オブジェクトの子項目の列挙を実行します。
アプリケーションは、ppIEnumWiaItem2 パラメーターを介して受け取るインターフェイス ポインターで IUnknown::Release メソッドを呼び出す必要があります。
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント |
Windows Vista [デスクトップ アプリのみ] |
サポートされている最小のサーバー |
Windows Server 2008 [デスクトップ アプリのみ] |
Header |
|
IDL |
|