IEnumEventObject::Next メソッド (eventsys.h)

列挙シーケンス内の指定した数の項目を取得します。

構文

HRESULT Next(
  [in]  ULONG    cReqElem,
  [out] IUnknown **ppInterface,
  [out] ULONG    *cRetElem
);

[in] cReqElem

要求される要素の数。シーケンスに残っている要素の数が要求された数より少ない場合、このメソッドは残りの要素を取得します。

[out] ppInterface

取得した最初のオブジェクトの IUnknown インターフェイスへのポインターへのアドレス。このパラメーターを NULL にすることはできません。

[out] cRetElem

実際に取得された要素の数。このパラメーターを NULL にすることはできません。

このメソッドは、標準の戻り値E_INVALIDARG、E_POINTER、E_OUTOFMEMORY、E_UNEXPECTED、E_FAIL、および次の値を返すことができます。

リターンコード	説明
S_OK	要求されたすべての要素が取得されました。
S_FALSE	要求されたすべての要素が取得されたわけではありません。取得した要素の数は、pcRetElem に書き込まれます。

要件	値
サポートされている最小のクライアント	Windows 2000 Professional [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップアプリのみ]
対象プラットフォーム	Windows
ヘッダー	eventsys.h