Метод IScheduledWorkItem::GetRunTimes (mstask.h)

Статья
08/25/2023

[[Этот 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

Поделиться через