Метод IActionCollection::Create (taskschd.h)

Создает и добавляет новое действие в коллекцию.

Синтаксис

HRESULT Create(
  [in]  TASK_ACTION_TYPE type,
  [out] IAction          **ppAction
);

Параметры

[in] type

Для этого параметра задается одна из следующих TASK_ACTION_TYPE констант перечисления.

Значение Значение
TASK_ACTION_EXEC
0
Действие выполняет операцию командной строки. Например, действие может запустить скрипт, запустить исполняемый файл или, если указано имя документа, найти связанное с ним приложение и запустить приложение с документом.
TASK_ACTION_COM_HANDLER
5
Действие запускает обработчик.
TASK_ACTION_SEND_EMAIL
6
Это действие отправляет сообщение электронной почты.
TASK_ACTION_SHOW_MESSAGE
7
Это действие отображает окно сообщения.

[out] ppAction

Интерфейс IAction , представляющий новое действие.

Передайте ссылку на указатель интерфейса NULL IAction. Ссылка на указатель, отличный от NULL , может привести к утечке памяти, так как указатель будет перезаписан.

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

Если этот метод завершается успешно, он возвращает S_OK. В противном случае возвращается код ошибки HRESULT .

Комментарии

В коллекцию нельзя добавить более 32 действий.

Требования

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

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

IAction

IActionCollection

IComHandlerAction

IEmailAction

IExecAction

IShowMessageAction

TASK_ACTION_TYPE

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