Initialize Method (session, resourcePath, internalUILevel)

Deployment Tools Foundation Initialize Method (session, resourcePath, internalUILevel)

Initializes the embedded UI.

Declaration Syntax

Visual Basic

Visual C++

bool Initialize(
	Session session,
	string resourcePath,
	ref InstallUIOptions internalUILevel
)

Function Initialize ( 
	session As Session,
	resourcePath As String,
	ByRef internalUILevel As InstallUIOptions
) As Boolean

bool Initialize(
	Session^ session, 
	String^ resourcePath, 
	InstallUIOptions% internalUILevel
)

Parameters

session (Session): Handle to the installer which can be used to get and set properties. The handle is only valid for the duration of this method call.

resourcePath (String): Path to the directory that contains all the files from the MsiEmbeddedUI table.

internalUILevel (InstallUIOptions%): On entry, contains the current UI level for the installation. After this method returns, the installer resets the UI level to the returned value of this parameter.

Return Value

Boolean
True if the embedded UI was successfully initialized; false if the installation should continue without the embedded UI.

Remarks

Exceptions

Exception	Condition
InstallCanceledException	The installation was canceled by the user.
InstallerException	The embedded UI failed to initialize and causes the installation to fail.

Assembly: Microsoft.Deployment.WindowsInstaller (Module: Microsoft.Deployment.WindowsInstaller.dll) Version: 3.0.0.0 (3.9.1006.0)