The MsiSetMode function sets an internal engine Boolean state.

Syntax

C++UINT MsiSetMode(
  __in  MSIHANDLE hInstall,
  __in  unsigned int iRunMode,
  __in  BOOL fState
);

Parameters

hInstall [in]

Handle to the installation provided to a DLL custom action or obtained through MsiOpenPackage, MsiOpenPackageEx, or MsiOpenProduct.

iRunMode [in]

Specifies the run mode. This parameter must be one of the following values. While there are many values for this parameter, as described in MsiGetMode, only one of the following values can be set.

Value	Meaning
MSIRUNMODE_REBOOTATEND	A reboot is necessary after a successful installation.
MSIRUNMODE_REBOOTNOW	A reboot is necessary to continue installation.

 

fState [in]

Specifies the state to set to TRUE or FALSE.

Return Value

ERROR_ACCESS_DENIED

Access was denied.

ERROR_INVALID_HANDLE

An invalid or inactive handle was supplied.

ERROR_SUCCESS

The function succeeded.

Requirements

See Also

Installer State Access Functions

Send comments about this topic to Microsoft

Build date: 8/13/2009