Метод ITaskScheduler::Activate (mstask.h)

Статья
02/29/2024

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

Метод Activate возвращает активный интерфейс для указанного рабочего элемента.

Синтаксис

HRESULT Activate(
  [in]  LPCWSTR  pwszName,
  [in]  REFIID   riid,
  [out] IUnknown **ppUnk
);

Параметры

[in] pwszName

Строка, завершающаяся нулевым значением, которая указывает имя рабочего элемента для активации.

[in] riid

Идентификатор, определяющий запрашиваемый интерфейс. Единственный поддерживаемый в настоящее время интерфейс ITask имеет идентификатор IID_ITask.

[out] ppUnk

Указатель на указатель интерфейса, который получает адрес запрошенного интерфейса.

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

При успешном выполнении этого метода возвращается S_OK.

Если метод завершается ошибкой, может быть возвращен один из следующих кодов ошибок.

Код возврата	Описание
COR_E_FILENOTFOUND	Задача не существует.
E_INVALIDARG	Недопустимый параметр pwszName .
E_OUTOFMEMORY	Сбой выделения памяти.
SCHED_E_UNKNOWN_OBJECT_VERSION	Версия объекта задачи либо не поддерживается, либо недопустимая.

Требования

Требование	Значение
Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	mstask.h
Библиотека	Mstask.lib
DLL	Mstask.dll
Распространяемые компоненты	Internet Обозреватель 4.0 или более поздней версии в Windows NT 4.0 и Windows 95

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

ITask

ITaskScheduler

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