支持要检索枚举序列中指定数量的项的远程客户端
语法
HRESULT RemoteNext(
[in] ULONG celt,
[out] IProgressItem **rgelt,
[out] ULONG *pceltFetched
);
参数
-
celt [in]
-
要检索的项数。
-
rgelt [out]
-
IProgressItem 接口的数组。 完成后，必须在 rgelt 中释放每个接口。
-
pceltFetched [out]
-
rgelt 中返回的元素数。 如果 celt 为一个，则可以将 pceltFetched 设置为 NULL。 否则，在调用此方法之前，将 pceltFetched 的值初始化为 0。
返回值
如果成功返回请求的元素数 (celt) ，或者 (pceltFetched) 返回的项数小于请求的元素数，则返回S_OK。
由于实现，可能会返回其他成功代码。 以下错误代码通常在操作失败时返回，但不表示唯一可能的错误值：
| 返回代码 | 说明 |
|---|---|
|
指针无效。 值：0x80004003 |
|
未能分配所需的内存。 值：0x8007000E |
|
一个或多个参数无效。 值：0x80070057 |
|
发生了意外失败。 值：0x8000FFFF |
备注
如果序列中剩余的元素数少于请求的元素数，它将检索剩余的元素。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 |
Windows Vista、Windows XP 和 SP2 [仅限桌面应用] |
| 最低受支持的服务器 |
Windows Server 2003 [仅限桌面应用] |
| IDL |
|