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