IEnumFORMATETC::Next メソッド (objidl.h)

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

構文

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

[in] celt

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

[out] rgelt

列挙された項目の配列。

列挙子はメモリの割り当てを担当し、呼び出し元はそれを解放する責任があります。 celt が 1 より大きい場合、呼び出し元は、解放するポインターの数を知るために、pceltFetched に渡される NULL 以外のポインターも渡す必要があります。

[in, out] pceltFetched

取得された項目の数。このパラメーターは、常に要求された項目の数以下です。 celt が 1 の場合、このパラメーターは NULL にすることができます。

メソッドが要求された項目の数を取得する場合、戻り値はS_OK。それ以外の場合は、S_FALSE。

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