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 |