Session.DoAction Method

Windows Installer

Session.DoAction Method

The DoAction method of the Session object executes the action function corresponding to the name supplied. If a Null action name is supplied, the engine uses the uppercase value of the ACTION property as the action to perform. If no property value is defined, the default action is performed, currently defined as INSTALL. This method returns an integer enumeration.

Syntax

Script
DoAction(
  action
)

Parameters

action

Required string name of the action to execute. Case-sensitive.

Return Value

This method does not return a value.

Remarks

Actions that update the system, such as the InstallFiles and WriteRegistryValues actions, cannot be run by calling the DoAction method. The exception to this rule is if the DoAction method is called from a custom action that is scheduled in the InstallExecuteSequence table between the InstallInitialize and InstallFinalize actions. Actions that do not update the system, such as AppSearch or CostInitialize, can be called.

Requirements

VersionWindows Installer 5.0 on Windows Server 2008 R2 or Windows 7. Windows Installer 4.0 or Windows Installer 4.5 on Windows Server 2008 or Windows Vista. Windows Installer on Windows Server 2003, Windows XP, and Windows 2000
DLLMsi.dll
IIDIID_ISession is defined as 000C109E-0000-0000-C000-000000000046

Send comments about this topic to Microsoft

Build date: 8/13/2009

© 2009 Microsoft Corporation. All rights reserved.