Deployment Tools Foundation
Initialize Method (session, resourcePath, internalUILevel)
Deployment Tools Foundation Namespaces ► Microsoft.Deployment.WindowsInstaller ► IEmbeddedUI ► Initialize(Session, String, InstallUIOptions%)
Initializes the embedded UI.
Declaration Syntax
C# | 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
True if the embedded UI was successfully initialized; false if the installation
should continue without the embedded UI.
Remarks
Win32 MSI API: InitializeEmbeddedUI
Exceptions
Exception | Condition |
---|---|
InstallCanceledException | The installation was canceled by the user. |
InstallerException | The embedded UI failed to initialize and
causes the installation to fail. |