IEnumShellItems::Next メソッド (shobjidl_core.h)

列挙体から 1 つ以上の IShellItem インターフェイスの配列を取得します。

構文

HRESULT Next(
  [in]  ULONG      celt,
  [out] IShellItem **rgelt,
  [out] ULONG      *pceltFetched
);

Parameters

[in] celt

型: ULONG

rgelt パラメーターによって参照される配列内の要素の数。

[out] rgelt

型: IShellItem**

列挙された項目を受け取る IShellItem インターフェイスへのポインターの配列のアドレス。 呼び出し元のアプリケーションは、IUnknown::Release メソッドを呼び出して IShellItem インターフェイスを解放します。

[out] pceltFetched

型: ULONG*

正常に取得された IShellItem インターフェイスの数を受け取る値へのポインター。 カウントは、 celt パラメーターで指定された値よりも小さくすることができます。 このパラメーターは、celt が 1 の場合にのみ、エントリに NULL を指定できます。その場合、メソッドは 1 つの項目のみを取得してS_OKを返すか、0 個の項目を返してS_FALSEを返すことができるためです。

戻り値

型: HRESULT

このメソッドは、これらの値のいずれかを返すことができます。

リターン コード Description
S_OK
 少なくとも 1 つの IShellItem インターフェイスが取得された場合。
S_FALSE
 列挙体にこれ以上 IShellItem インターフェイスがない場合は。
その他の理由で関数が失敗した場合は、エラー値を返します。

Requirements

Requirement 価値
サポートされる最小クライアント Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2008 [デスクトップ アプリのみ]
ターゲット プラットフォーム の Windows
ヘッダー shobjidl_core.h (Shobjidl.h を含む)

こちらも参照ください

IEnumShellItems

IShellItem

  • Last updated on