通过

IScheduledWorkItem：：GetRunTimes 方法 (mstask.h)

  • 项目

[[此 API 可能在操作系统或产品的后续版本中被更改或不可用。 请改用 任务计划程序 2.0 接口 。] ]

检索指定时间段 内的工作项 运行时间。

语法

HRESULT GetRunTimes(
  [in]      const LPSYSTEMTIME pstBegin,
  [in]      const LPSYSTEMTIME pstEnd,
  [in, out] WORD               *pCount,
  [out]     LPSYSTEMTIME       *rgstTaskTimes
);

参数

[in] pstBegin

指向 SYSTEMTIME 结构的指针，该结构包含要检查的时间段的开始时间。 最大值包含在内。

[in] pstEnd

指向 SYSTEMTIME 结构的指针，该结构包含要检查的时间段的结束时间。 此值是独占的。 如果为此值传递 NULL ，则结束时间是无限的。

[in, out] pCount

指向 WORD 值的指针，该值指定要检索的运行时间。

输入时，此参数包含所请求的运行次数。 这可以是介于 1 到 TASK_MAX_RUN_TIMES 之间的数字。

在输出时，此参数包含检索的运行次数。

[out] rgstTaskTimes

指向 SYSTEMTIME 结构数组的指针。 应将 NULL LPSYSTEMTIME 对象传递到此参数中。 返回时，此数组包含 pCount 运行时间。 必须通过调用 CoTaskMemFree 函数来释放此数组。

返回值

GetRunTimes 方法返回以下值之一。

返回代码 说明
S_OK
 已检索请求的运行次数。
S_FALSE
 方法成功，但检索的运行时间少于请求的运行时间。 检索的运行次数包含在 pCount 指向的值中。 如果检索的运行次数为零，则也没有可能导致在指定时间段内执行工作项的基于事件的触发器。
SCHED_S_TASK_NO_VALID_TRIGGERS
 工作项已启用，但没有有效的触发器。
SCHED_S_TASK_DISABLED
 已禁用工作项。
E_INVALIDARG
 一个或多个参数无效。
E_OUTOFMEMORY
 内存不足，无法计算结果。

要求

要求 值
最低受支持的客户端 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 或更高版本

另请参阅

IScheduledWorkItem