IAction interface (taskschd.h)

Article
02/16/2023

Provides the common properties inherited by all action objects. An action object is created by the IActionCollection::Create method.

Inheritance

The IAction interface inherits from the IDispatch interface.

Methods

The IAction interface has these methods.


IAction::get_Id Gets or sets the identifier of the action. (Get)
IAction::get_Type Gets the type of action.
IAction::put_Id Gets or sets the identifier of the action. (Put)

Remarks

For more information about how actions and tasks work together, see Task Actions. The following table contains the interfaces that represent the actions that can be performed:

API	Description
IComHandlerAction	Represents an action that fires a handler.
IExecAction	Represents an action that executes a command-line operation.
IEmailAction	Represents an action that sends an email message.
IShowMessageAction	Represents an action that shows a message box.

When reading or writing XML, the actions of a task are specified in the Actions element of the Task Scheduler schema.

Examples

For more information and a code example for this interface, see Time Trigger Example (C++), Event Trigger Example (C++), Daily Trigger Example (C++), Registration Trigger Example (C++), Weekly Trigger Example (C++), Logon Trigger Example (C++), or Boot Trigger Example (C++).

Requirements

Requirement	Value
Minimum supported client	Windows Vista [desktop apps only]
Minimum supported server	Windows Server 2008 [desktop apps only]
Target Platform	Windows
Header	taskschd.h