Метод 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
Header mstask.h
Библиотека Mstask.lib
DLL Mstask.dll
Распространяемые компоненты Internet Обозреватель 4.0 или более поздней версии в Windows NT 4.0 и Windows 95

См. также раздел

IScheduledWorkItem