IEnumWorkItems：：Next 方法 (mstask.h)
[[此 API 可能在操作系统或产品的后续版本中被更改或不可用。 请改用 任务计划程序 2.0 接口 。] ]
检索枚举序列中下一个指定数量的任务。
如果序列中剩余的任务数少于请求的任务数，则会检索所有剩余的元素。
语法
HRESULT Next(
[in] ULONG celt,
[out] LPWSTR **rgpwszNames,
[out] ULONG *pceltFetched
);
参数
[in] celt
要检索的任务数。
[out] rgpwszNames
指向指针数组的指针 (LPWSTR) 以 null 结尾的字符串，其中包含从枚举序列返回的任务的文件名。 这些文件名取自 “计划任务”文件夹 ，扩展名为“.job”。
处理 rgpwszNames 中返回的名称后，必须先释放数组中的每个字符串，然后使用 CoTaskMemFree 释放数组本身。
[out] pceltFetched
指向 rgpwszNames 中返回的任务数的指针。 如果 celt 参数为 1，则此参数可以为 NULL。
返回值
返回以下值之一。
| 返回代码 | 说明 |
|---|---|
|
检索的任务数等于请求的数量。 |
|
返回的数字小于请求的数字。 (因此，没有更多的任务要枚举.) |
|
参数无效。 |
|
内存不足。 |
注解
IEnumWorkItems 接口还提供用于重置枚举、跳过任务和创建枚举当前状态的副本的方法。
示例
有关如何使用 Next 枚举“计划任务”文件夹中的任务的示例，请参阅 枚举任务示例。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | Windows 2000 Professional [仅限桌面应用] |
| 最低受支持的服务器 | Windows 2000 Server [仅限桌面应用] |
| 目标平台 | Windows |
| 标头 | mstask.h |
| Library | Mstask.lib |
| DLL | Mstask.dll |
| 可再发行组件 | Windows NT 4.0 和 Windows 95 上的 Internet Explorer 4.0 或更高版本 |