IEnumUnknown::Next メソッド (objidlbase.h)
列挙シーケンス内の指定した数の項目を取得します。
構文
HRESULT Next(
[in] ULONG celt,
[out] IUnknown **rgelt,
[out] ULONG *pceltFetched
);
パラメーター
[in] celt
取得する項目の数。 シーケンスに残っている項目の数が要求された数より少ない場合、このメソッドは残りの要素を取得します。
[out] rgelt
列挙された項目の配列。
列挙子は AddRef を呼び出す役割を担い、呼び出し元は列挙された各ポインターを使用して Release を 呼び出す役割を担います。 celt が 1 より大きい場合、呼び出し元は、解放するポインターの数を知るために、pceltFetched に渡される NULL 以外のポインターも渡す必要があります。
[out] pceltFetched
取得された項目の数。 このパラメーターは、常に要求された項目の数以下です。
戻り値
メソッドが要求された項目数を取得した場合、戻り値はS_OK。 それ以外の場合は、S_FALSE。
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリ |UWP アプリ] |
サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリ |UWP アプリ] |
対象プラットフォーム | Windows |
ヘッダー | objidlbase.h (ObjIdl.h を含む) |