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

  • [アーティクル]

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

構文

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

パラメーター

[in] celt

種類: ULONG

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

[out] rgelt

種類: IShellItem**

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

[out] pceltFetched

種類: ULONG*

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

戻り値

型: HRESULT

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

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

要件

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

こちらもご覧ください

IEnumShellItems

Ishellitem