IWiaItem::EnumChildItems メソッド (wia_xp.h)

IWiaItem::EnumChildItems メソッドは、列挙子オブジェクトを作成し、Windows イメージ取得 (WIA) デバイスの IWiaItem ツリー内の空でないフォルダーの IEnumWiaItem インターフェイスへのポインターを返します。

構文

HRESULT EnumChildItems(
  [out] IEnumWiaItem **ppIEnumWiaItem
);

パラメーター

[out] ppIEnumWiaItem

種類: IEnumWiaItem**

IWiaItem::EnumChildItems によって作成される IEnumWiaItem インターフェイスへのポインターのアドレスを受け取ります。

戻り値

種類: HRESULT

このメソッドは、成功すると S_OK を返します。 そうでない場合は、HRESULT エラー コードを返します。

解説

WIA ランタイム システムは、各 WIA ハードウェア デバイスを IWiaItem オブジェクトの階層ツリーとして表します。 IWiaItem::EnumChildItems メソッドを使用すると、アプリケーションは現在のアイテムの子項目を列挙できます。 ただし、フォルダーであるアイテムにのみ適用できます。

フォルダーが空でない場合は、 IWiaItem オブジェクトのサブツリーが含まれます。 IWiaItem::EnumChildItems メソッドは、フォルダーに含まれるすべてのアイテムを列挙します。 ppIEnumWiaItem パラメーターに列挙子へのポインターを格納します。 アプリケーションでは、列挙子ポインターを使用して、オブジェクトの子項目の列挙を実行します。

アプリケーションは、ppIEnumWiaItem パラメーターを介して受け取るインターフェイス ポインターで IUnknown::Release メソッドを呼び出す必要があります。

要件