IRegisteredTask：：GetRunTimes 方法 (taskschd.h)

  • 项目

获取计划注册任务在指定时间内运行的时间。

语法

HRESULT GetRunTimes(
  [in]      const LPSYSTEMTIME pstStart,
  [in]      const LPSYSTEMTIME pstEnd,
  [in, out] DWORD              *pCount,
  [out]     LPSYSTEMTIME       *pRunTimes
);

参数

[in] pstStart

查询的开始时间。

[in] pstEnd

查询的结束时间。

[in, out] pCount

输入时请求的运行数和输出时返回的运行数。

[out] pRunTimes

任务将运行的计划时间。 应将 NULL LPSYSTEMTIME 对象传递到此参数中。 返回时，此数组包含 pCount 运行时间。 必须通过调用 CoTaskMemFree 函数来释放此数组。

返回值

如果该方法成功，则它会返回 S_OK。 如果方法返回S_FALSE，则 pRunTimes 参数包含 pCount 项，但任务运行更多，未返回。 否则，它将返回 HRESULT 错误代码。

备注

如果已注册的任务包含单独禁用的触发器，这些触发器仍将影响返回的下一个计划运行时间，即使它们被禁用。

要求

要求 值
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 [仅限桌面应用]
目标平台 Windows
标头 taskschd.h
Library Taskschd.lib
DLL Taskschd.dll

另请参阅

IRegisteredTask

任务计划程序