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

Статья
08/25/2023

[[Этот API может быть изменен или недоступен в последующих версиях операционной системы или продукта. Вместо этого используйте интерфейсы планировщика задач 2.0 .] ]

Извлекает последний код выхода, возвращенный исполняемым файлом, связанным с рабочим элементом при последнем запуске. Метод также возвращает код выхода, возвращенный планировщику задач при последней попытке запустить рабочий элемент.

Синтаксис

HRESULT GetExitCode(
  [out] DWORD *pdwExitCode
);

Параметры

[out] pdwExitCode

Указатель на значение DWORD , заданное последним кодом выхода для рабочего элемента. Это код выхода, возвращаемый рабочим элементом при последней остановке выполнения. Если рабочий элемент никогда не запускался, возвращается значение 0.

Возвращаемое значение

Метод GetExitCode возвращает ошибку при последней попытке запустить рабочий элемент. Ниже приведены возможные значения.

Код возврата	Описание
S_OK	Попытка запустить рабочий элемент была успешной.
SCHED_S_TASK_HAS_NOT_RUN	Попытки запустить этот рабочий элемент не предпринимались.
E_INVALIDARG	Недопустимые аргументы.
E_OUTOFMEMORY	Недостаточно памяти.

Код ошибки или выхода, возвращаемый запланированным исполняемым файлом, возвращается в параметре pdwExitCode .
Код ошибки, полученный планировщиком задач при попытке запустить задание, возвращается в вызове метода GetExitCode .

Чтобы получить обновленный код ошибки, всегда сначала вызывайте ITaskScheduler::Activate , чтобы получить новый интерфейс IScheduledWorkItem , который затем можно использовать для получения обновленных кодов ошибок.

Примеры

Пример получения создателя задачи см. в разделе Пример кода C/C++. Получение кода выхода из задачи.

Требования

Требование	Значение
Минимальная версия клиента	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

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