IActionCollection::Create method

Creates and adds a new action to the collection.

Syntax

HRESULT Create(
  TASK_ACTION_TYPE type,
  IAction          **ppAction
);

Parameters

type

This parameter is set to one of the following TASK_ACTION_TYPE enumeration constants.

Value Meaning
TASK_ACTION_EXEC
0
The action performs a command-line operation. For example, the action could run a script, start an executable, or, if the name of a document is provided, find its associated application and start the application with the document.
TASK_ACTION_COM_HANDLER
5
The action fires a handler.
TASK_ACTION_SEND_EMAIL
6
This action sends an email message.
TASK_ACTION_SHOW_MESSAGE
7
This action shows a message box.

ppAction

An IAction interface that represents the new action.

Pass in a reference to a NULL IAction interface pointer. Referencing a non-NULL pointer can cause a memory leak because the pointer will be overwritten.

Return Value

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Remarks

You cannot add more than 32 actions to the collection.

Requirements

   
Minimum supported client Windows Vista [desktop apps only]
Minimum supported server Windows Server 2008 [desktop apps only]
Target Platform Windows
Header taskschd.h
Library Taskschd.lib
DLL Taskschd.dll

See Also

IAction

IActionCollection

IComHandlerAction

IEmailAction

IExecAction

IShowMessageAction

TASK_ACTION_TYPE

Task Scheduler