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


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

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