IEnumProgressItems::Next メソッド (imapi2fs.h)
列挙体シーケンス内の指定した数の項目を取得します。
構文
HRESULT Next(
[in] ULONG celt,
[out] IProgressItem **rgelt,
[out] ULONG *pceltFetched
);
パラメーター
[in] celt
取得する項目の数。
[out] rgelt
IProgressItem インターフェイスの配列。 完了したら、rgelt の各インターフェイスを解放する必要があります。
[out] pceltFetched
rgelt で返される要素の数。 celt が 1 の場合は、pceltFetchedを NULL に設定できます。 それ以外の場合は、このメソッドを呼び出す前に 、pceltFetched の値を 0 に初期化します。
戻り値
S_OKは、要求された要素 (celt) の数が正常に返されるか、返された項目の数 (pceltFetched) が要求された要素の数より少ない場合に返されます。
その他の成功コードは、実装の結果として返される場合があります。 次のエラー コードは、通常、操作の失敗時に返されますが、考えられる唯一のエラー値を表すわけではありません。
| リターン コード | 説明 |
|---|---|
|
ポインターが無効です。
値: 0x80004003 |
|
必要なメモリを割り当てませんでした。
値: 0x8007000E |
|
1 つ以上の引数が無効です。
値: 0x80070057 |
注釈
シーケンスに残っている要素の数が要求された数より少ない場合は、残りの要素が取得されます。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows Vista、SP2 を使用した Windows XP [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows Server 2003 (デスクトップ アプリのみ) |
| 対象プラットフォーム | Windows |
| ヘッダー | imapi2fs.h |