Метод IRegisteredTask::GetRunTimes (taskschd.h)

Статья
03/05/2024

Возвращает время выполнения зарегистрированной задачи в течение указанного времени.

Синтаксис

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.

Remarks

Если зарегистрированная задача содержит триггеры, которые отключены по отдельности, эти триггеры по-прежнему влияют на следующее запланированное время выполнения, которое возвращается, даже если они отключены.

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista [только классические приложения]
Минимальная версия сервера	Windows Server 2008 [только классические приложения]
Целевая платформа	Windows
Header	taskschd.h
Библиотека	Taskschd.lib
DLL	Taskschd.dll

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

IRegisteredTask

Планировщик заданий

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