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

Статья
07/16/2024

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

Синтаксис

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, представляющий новое действие.

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

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

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

Замечания

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

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows Vista [только классические приложения]
минимальный поддерживаемый сервер	Windows Server 2008 [только классические приложения]
целевая платформа	Виндоус
заголовка	taskschd.h
библиотеки	Taskschd.lib
DLL	Taskschd.dll