DoAction ControlEvent

Windows Installer

DoAction ControlEvent

The DoAction ControlEvent notifies the installer to execute a custom action. This event can be published by a PushButton control, CheckBox control, or a SelectionTree control. This event should be authored into the ControlEvent table.

Note that custom actions launched by a DoAction ControlEvent can send a message with the Message Method, but cannot send a message with MsiProcessMessage. On systems prior to Windows Server 2003, custom actions launched by a DoAction ControlEvent cannot send messages with MsiProcessMessage or Message Method. For more information, see Sending Messages to Windows Installer Using MsiProcessMessage.

This ControlEvent requires the user interface to be run at the full UI level. This event will not work with a reduced UI or basic UI. For more information, see User Interface Levels.

Published By

This ControlEvent is published by the installer.

Argument

A string, the name of the custom action to be executed.

Action on Subscribers

This ControlEvent does not perform an action on subscribers.

Typical Use

A PushButton control on a dialog box is tied to this event in the ControlEvent table to invoke a custom action.

Send comments about this topic to Microsoft

Build date: 8/13/2009

© 2009 Microsoft Corporation. All rights reserved.