IShowMessageAction interface (taskschd.h)

[This interface is no longer supported. You can use IExecAction with the Windows scripting MsgBox function to show a message in the user session.]

Represents an action that shows a message box when a task is activated.

Inheritance

The IShowMessageAction interface inherits from the IAction interface.

Methods

The IShowMessageAction interface has these methods.

 
IShowMessageAction::get_MessageBody

Gets or sets the message text that is displayed in the body of the message box. (Get)
IShowMessageAction::get_Title

Gets or sets the title of the message box. (Get)
IShowMessageAction::put_MessageBody

Gets or sets the message text that is displayed in the body of the message box. (Put)
IShowMessageAction::put_Title

Gets or sets the title of the message box. (Put)

Remarks

For a task, that contains a message box action, the message box will be displayed if the task is activated and the task has an interactive logon type. To set the task logon type to be interactive, specify TASK_LOGON_INTERACTIVE_TOKEN or TASK_LOGON_GROUP in the LogonType property of the task principal, or in the logonType parameter of ITaskFolder::RegisterTask or ITaskFolder::RegisterTaskDefinition.

When reading or writing your own XML for a task, a message box action is specified using the ShowMessage element of the Task Scheduler schema.

Examples

For more information and example code for this interface, see Message Box 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

See also

IAction