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