MSI.SetInternalUI

table MSI.SetInternalUI ( 

number UILevel,

number WindowHandle = nil )

Description

Calls the MsiSetInternalUI function to enable the installer's internal user interface. Then this user interface is used for all subsequent calls to user-interface-generating installer functions in this process. This action is usually called before calling the MSI.InstallProduct action.

Parameters

UILevel

(number) The user interface level to set. Some values can be combined with others. In that case, use the plus sign ("+") to combine values. Choose from:

CONSTANT

VALUE

DESCRIPTION

INSTALLUILEVEL_NOCHANGE

0

No change in the UI level. However, if WindowHandle is not nil, the parent window can change.

INSTALLUILEVEL_DEFAULT

1

The installer chooses an appropriate user interface level.

INSTALLUILEVEL_NONE

2

Completely silent installation.

INSTALLUILEVEL_BASIC

3

Simple progress and error handling.

INSTALLUILEVEL_REDUCED

4

Authored user interface with wizard dialog boxes suppressed.

INSTALLUILEVEL_FULL

5

Authored user interface with wizards, progress, and errors.

INSTALLUILEVEL_HIDECANCEL

32

If combined with the INSTALLUILEVEL_BASIC value, the installer shows simple progress dialog boxes but does not display a Cancel button on the dialog. This prevents users from canceling the install.

INSTALLUILEVEL_PROGRESSONLY

64

If combined with the INSTALLUILEVEL_BASIC value, the installer shows simple progress dialog boxes but does not display any modal dialog boxes or error dialog boxes.

INSTALLUILEVEL_ENDDIALOG

128

If combined with any above value, the installer displays a modal dialog box at the end of a successful installation or if there has been an error. No dialog box is displayed if the user cancels.

INSTALLUILEVEL_SOURCERESONLY

256

If this value is combined with the INSTALLUILEVEL_NONE value, the installer displays only the dialog boxes used for source resolution. No other dialog boxes are shown. This value has no effect if the UI level is not INSTALLUILEVEL_NONE. It is used with an external user interface designed to handle all of the UI except for source resolution. In this case, the installer handles source resolution.

WindowHandle

(number) A windows handle that becomes the owner of any user interface created. If this parameter is nil, the owner of the user interface does not change. You can use the Application.GetWndHandle action to get a handle to the application's main window.

Returns

(table) Returns nil if the call fails or a table if successful with the following indexes:

KEY

TYPE

DESCRIPTION

PreviousInterface

number

The previous user interface level.

PreviousWindowHandle

number

The previous window handle of the owner process. If WindowHandle was passed in as nil or not specified, this value will be nil.

If the action fails, nil is returned. You can use Application.GetLastError to determine whether this action failed, and why.

See also:  Related Actions