showmessageaction.md

title	description	ms.assetid	keywords	topic_type	api_name	api_location	api_type	ms.topic	ms.date
ShowMessageAction object	For scripting, represents an action that shows a message box when a task is activated.	fdd22eef-965c-4a81-954c-66011c435ab9	ShowMessageAction object Task Scheduler ShowMessageAction object Task Scheduler , described	apiref	ShowMessageAction	taskschd.dll	COM	reference	05/31/2018

ShowMessageAction object

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

For scripting, represents an action that shows a message box when a task is activated.

Members

The ShowMessageAction object has these types of members:

• Properties

Properties

The ShowMessageAction object has these properties.

Property	Access type	Description
Id	Read/write	Inherited from the Action object. Gets or sets the identifier of the action.
MessageBody	Read/write	Gets or sets the message text that is displayed in the body of the message box.
Title	Read/write	Gets or sets the title of the message box.
Type	Read-only	Inherited from the Action object. Gets the type of the action.

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 interactive, specify 3 (TASK_LOGON_INTERACTIVE_TOKEN) or 4 (TASK_LOGON_GROUP) in the LogonType property of the task principal, or in the logonType parameter of TaskFolder.RegisterTask or TaskFolder.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 scripting object, see Message Box Example (Scripting).

Requirements

Requirement	Value
Minimum supported client	Windows Vista [desktop apps only]
Minimum supported server	Windows Server 2008 [desktop apps only]
End of client support	Windows 7
End of server support	Windows Server 2008 R2
Type library	Taskschd.tlb
DLL	Taskschd.dll