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 或更高版本