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 |