次の方法で共有

IEnumWiaItem::Next メソッド (wia_xp.h)

  • [アーティクル]

IEnumWiaItem::Next メソッドは、IWiaItem インターフェイスへのポインターの配列を格納します。

構文

HRESULT Next(
  [in]      ULONG    celt,
  [out]     IWiaItem **ppIWiaItem,
  [in, out] ULONG    *pceltFetched
);

パラメーター

[in] celt

種類: ULONG

ppIWiaItem パラメーターによって示される配列内の配列要素の数を指定します。

[out] ppIWiaItem

種類: IWiaItem**

IWiaItem インターフェイス ポインターの配列のアドレスを受け取ります。 IEnumWiaItem::Next は 、この配列をインターフェイス ポインターで埋めます。

[in, out] pceltFetched

種類: ULONG*

出力時に、このパラメーターは ppIWiaItem パラメーターによって示される配列に実際に格納されているインターフェイス ポインターの数を受け取ります。 列挙が完了すると、このパラメーターには 0 が含まれます。

戻り値

種類: HRESULT

メソッドが成功した場合、メソッドは S_OKを返します。 列挙が完了すると、S_FALSEが返されます。 メソッドが失敗した場合は、標準の COM エラー コードが返されます。

注釈

Windows イメージ取得 (WIA) ランタイム システムは、WIA ハードウェア デバイスを IWiaItem オブジェクトの階層ツリーとして表します。 アプリケーションでは 、IEnumWiaItem::Next メソッドを使用して、ハードウェア デバイスの IWiaItem オブジェクト ツリーの現在のフォルダーにある各項目の IWiaItem インターフェイス ポインターを取得します。

ポインターの一覧を取得するために、アプリケーションは割り当てる IWiaItem インターフェイス ポインターの配列を渡します。 また、 celt パラメーター内の配列要素の数も渡します。 IEnumWiaItem::Next メソッドは、配列に IWiaItem インターフェイスへのポインターを入力します。

列挙プロセスが完了するまで、 IEnumWiaItem::Next メソッドはS_OKを返します。 そのたびに、 pceltFetched によって指される値が、配列に挿入された項目の数に設定されます。 IEnumWiaItem::Next は IWiaItem オブジェクトの列挙プロセスを終了すると、S_FALSEを返し、pceltFetched が指すメモリ位置を 0 に設定します。

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

要件

要件 値
サポートされている最小のクライアント Windows 2000 Professional、Windows XP [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム Windows
ヘッダー wia_xp.h (Wia.h を含む)
Library Wiaguid.lib