MsiSetInternalUI-Funktion (msi.h)

  • Artikel

Die MsiSetInternalUI-Funktion aktiviert die interne Benutzeroberfläche des Installationsprogramms. Anschließend wird diese Benutzeroberfläche für alle nachfolgenden Aufrufe von Benutzeroberflächen-generierenden Installationsprogrammfunktionen in diesem Prozess verwendet. Weitere Informationen finden Sie unter Benutzeroberflächenebenen.

Syntax

INSTALLUILEVEL MsiSetInternalUI(
  [in]      INSTALLUILEVEL dwUILevel,
  [in, out] HWND           *phWnd
);

Parameter

[in] dwUILevel

Gibt den Komplexitätsgrad der Benutzeroberfläche an. Dieser Parameter kann einen der folgenden Werte annehmen.

Wert Bedeutung
INSTALLUILEVEL_FULL
 Erstellte Benutzeroberfläche mit Assistenten, Status und Fehlern.
INSTALLUILEVEL_REDUCED
 Erstellte Benutzeroberfläche mit unterdrückten Dialogfeldern des Assistenten.
INSTALLUILEVEL_BASIC
 Einfache Fortschritts- und Fehlerbehandlung.
INSTALLUILEVEL_DEFAULT
 Das Installationsprogramm wählt eine geeignete Benutzeroberflächenebene aus.
INSTALLUILEVEL_NONE
 Vollständig automatische Installation: Dies schließt das Unterdrücken der Eingabeaufforderung für rechte Rechte ein, selbst wenn erforderlich. Weitere Informationen finden Sie unter INSTALLUILEVEL_UACONLY , wenn Sie möchten, dass der Benutzer erhöhte Rechte erhöhen kann.
INSTALLUILEVEL_ENDDIALOG
 In Kombination mit einem der oben genannten Werte zeigt das Installationsprogramm ein modales Dialogfeld am Ende einer erfolgreichen Installation an, oder wenn ein Fehler aufgetreten ist. Wenn der Benutzer den Vorgang abbricht, wird kein Dialogfeld angezeigt.
INSTALLUILEVEL_PROGRESSONLY
 In Kombination mit dem wert INSTALLUILEVEL_BASIC zeigt das Installationsprogramm einfache Statusdialogfelder an, zeigt jedoch keine modale Dialogfelder oder Fehlerdialogfelder an.
INSTALLUILEVEL_NOCHANGE
 Keine Änderung der Ui-Ebene. Wenn phWnd jedoch nicht Null ist, kann sich das übergeordnete Fenster ändern.
INSTALLUILEVEL_HIDECANCEL
 In Kombination mit dem wert INSTALLUILEVEL_BASIC zeigt das Installationsprogramm einfache Statusdialogfelder an, zeigt jedoch keine Schaltfläche Abbrechen im Dialogfeld an. Dadurch wird verhindert, dass Benutzer die Installation abbrechen.
INSTALLUILEVEL_SOURCERESONLY
 Wenn dieser Wert mit dem wert INSTALLUILEVEL_NONE kombiniert wird, zeigt das Installationsprogramm nur die Dialogfelder an, die für die Quellauflösung verwendet werden. Es werden keine weiteren Dialogfelder angezeigt. Dieser Wert hat keine Auswirkung, wenn die Ui-Ebene nicht INSTALLUILEVEL_NONE ist. Es wird mit einer externen Benutzeroberfläche verwendet, die für die gesamte Benutzeroberfläche mit Ausnahme der Quellauflösung konzipiert ist. In diesem Fall verarbeitet das Installationsprogramm die Quellauflösung.
INSTALLUILEVEL_UACONLY
 In Kombination mit dem INSTALLUILEVEL_NONE-Wert erfolgt die Installation vollständig im Hintergrund, mit Ausnahme der Aufforderung zur Erhöhung, falls erforderlich.

[in, out] phWnd

Zeiger auf ein Fenster. Dieses Fenster wird zum Besitzer einer beliebigen erstellten Benutzeroberfläche. Ein Zeiger auf den vorherigen Besitzer der Benutzeroberfläche wird zurückgegeben. Wenn dieser Parameter NULL ist, ändert sich der Besitzer der Benutzeroberfläche nicht.

Rückgabewert

Die vorherige Benutzeroberflächenebene wird zurückgegeben. Wenn ein ungültiger dwUILevel-Wert übergeben wird, wird INSTALLUILEVEL_NOCHANGE zurückgegeben.

Hinweise

Die MsiSetInternalUI-Funktion ist nützlich, wenn das Installationsprogramm eine Benutzeroberfläche anzeigen muss. Wenn beispielsweise ein Feature installiert ist, aber die Quelle eine CD ist, die eingefügt werden muss, fordert das Installationsprogramm den Benutzer zur Eingabe der CD auf. Je nach Art der Installation zeigt die Anwendung möglicherweise auch Statusanzeigen an oder fragt den Benutzer nach Informationen ab.

Wenn Msi.dll geladen wird, wird die Benutzeroberflächenebene auf DEFAULT und der Benutzeroberflächenbesitzer auf 0 festgelegt (d. a. der ursprüngliche Benutzeroberflächenbesitzer ist der Desktop).

Anforderungen

   
Unterstützte Mindestversion (Client) Windows Installer 5.0 unter Windows Server 2012, Windows 8, Windows Server 2008 R2 oder Windows 7. Windows Installer 4.0 oder Windows Installer 4.5 unter Windows Server 2008 oder Windows Vista. Informationen zum minimal erforderlichen Windows Service Pack für eine Windows Installer-Version finden Sie unter Windows Installer – Laufzeitanforderungen.
Zielplattform Windows
Kopfzeile msi.h
Bibliothek Msi.lib
DLL Msi.dll

Weitere Informationen

Schnittstellen- und Protokollierungsfunktionen