INSTALLUI_HANDLERA Rückruffunktion (msi.h)

  • Artikel

Der INSTALLUI_HANDLER Funktionsprototyp definiert eine Rückruffunktion, die das Installationsprogramm für Statusbenachrichtigungen und Fehlermeldungen aufruft. Weitere Informationen zur Verwendung dieses Funktionsprototyps finden Sie unter Behandeln von Statusmeldungen mithilfe von MsiSetExternalUI.

Syntax

INSTALLUI_HANDLERA InstalluiHandlera;

int InstalluiHandlera(
  LPVOID pvContext,
  UINT iMessageType,
  LPCSTR szMessage
)
{...}

Parameter

pvContext

Zeiger auf einen Anwendungskontext, der an die MsiSetExternalUI-Funktion übergeben wird. Dieser Parameter kann für die Fehlerüberprüfung verwendet werden.

iMessageType

Gibt eine Kombination aus einem Nachrichtenfeldformat, einem Symboltyp des Nachrichtenfelds, einer Standardschaltfläche und einem Installationsmeldungstyp an. Dieser Parameter muss einer der folgenden Parameter sein.

Meldungsfeld StylesFlag Bedeutung
MB_ABORTRETRYIGNORE
 Das Meldungsfeld enthält die Schaltflächen Abbrechen, Wiederholen und Ignorieren .
MB_OK
 Das Meldungsfeld enthält die Schaltfläche OK . Dies ist die Standardoption.
MB_OKCANCEL
 Das Meldungsfeld enthält die Schaltflächen OK und Abbrechen .
MB_RETRYCANCEL
 Das Meldungsfeld enthält die Schaltflächen Wiederholen und Abbrechen .
MB_YESNO
 Das Meldungsfeld enthält die Schaltflächen Ja und Nein .
MB_YESNOCANCEL
 Das Meldungsfeld enthält die Schaltflächen Ja, Nein und Abbrechen .
 
Meldungsfeld IconTypesFlag Bedeutung
MB_ICONEXCLAMATION, MB_ICONWARNING
 Im Meldungsfeld wird ein Ausrufezeichen angezeigt.
MB_ICONINFORMATION, MB_ICONASTERISK
 Das Informationszeichen wird im Meldungsfeld angezeigt.
MB_ICONQUESTION
 Im Meldungsfeld wird ein Fragezeichen angezeigt.
MB_ICONSTOP, MB_ICONERROR, MB_ICONHAND
 Im Meldungsfeld wird ein Stoppzeichen angezeigt.
 
StandardschaltflächenFlag Bedeutung
MB_DEFBUTTON1
 Die erste Schaltfläche ist die Standardschaltfläche.
MB_DEFBUTTON2
 Die zweite Schaltfläche ist die Standardschaltfläche.
MB_DEFBUTTON3
 Die dritte Schaltfläche ist die Standardschaltfläche.
 
Installieren der Meldung TypesFlag Bedeutung
INSTALLMESSAGE_FATALEXIT
 Vorzeitige Beendigung
INSTALLMESSAGE_ERROR
 Formatierte Fehlermeldung
INSTALLMESSAGE_WARNING
 Formatierte Warnmeldung
INSTALLMESSAGE_USER
 Benutzeranforderungsnachricht.
INSTALLMESSAGE_INFO
 Informative Meldung für das Protokoll
INSTALLMESSAGE_FILESINUSE
 Liste der derzeit verwendeten Dateien, die geschlossen werden müssen, bevor sie ersetzt werden.
INSTALLMESSAGE_RESOLVESOURCE
 Anforderung zum Ermitteln eines gültigen Quellspeicherorts
INSTALLMESSAGE_RMFILESINUSE
 Liste der derzeit verwendeten Dateien, die geschlossen werden müssen, bevor sie ersetzt werden. Verfügbar ab Windows Installer 4.0. Weitere Informationen zu dieser Meldung finden Sie unter Verwenden des Neustart-Managers mit einer externen Benutzeroberfläche.
INSTALLMESSAGE_OUTOFDISKSPACE
 Meldung zu unzureichendem Speicherplatz
INSTALLMESSAGE_ACTIONSTART
 Meldung zum Start der Aktion. Diese Meldung enthält den Aktionsnamen und die Beschreibung.
INSTALLMESSAGE_ACTIONDATA
 Formatierte Daten, die dem einzelnen Aktionselement zugeordnet sind.
INSTALLMESSAGE_PROGRESS
 Statusanzeigeinformationen. Diese Meldung enthält Informationen zu den bisherigen Einheiten und der Gesamtzahl der Einheiten.
INSTALLMESSAGE_COMMONDATA
 Formatierte Dialoginformationen für die Benutzeroberfläche.
INSTALLMESSAGE_INITIALIZE
 Vor der Benutzeroberflächeninitialisierung gesendet, keine Zeichenfolgendaten
INSTALLMESSAGE_TERMINATE
 Nach Beendigung der Benutzeroberfläche gesendet, keine Zeichenfolgendaten
INSTALLMESSAGE_SHOWDIALOG
 Wird vor der Anzeige des erstellten Dialogfelds oder Assistenten gesendet
INSTALLMESSAGE_INSTALLSTART
 Wird vor der Installation des Produkts gesendet.
INSTALLMESSAGE_INSTALLEND
 Wird nach der Installation des Produkts gesendet.
 
 

Die folgenden Standardwerte sollten verwendet werden, wenn eine der vorherigen Meldungen fehlt: MB_OK, kein Symbol und MB_DEFBUTTON1. Es gibt keinen Standardmäßigen Installationsmeldungstyp. Ein Nachrichtentyp wird immer angegeben.

szMessage

Gibt den Nachrichtentext an.

Rückgabewert

Die folgenden Rückgabewerte werden den Schaltflächen zugeordnet, die im Meldungsfeldformat angegeben werden:

IDOK

 
IDCANCEL
 
IDABORT
 
IDRETRY
 
IDIGNORE
 
IDYES
 
IDNO

Hinweise

Weitere Informationen zum Zurückgeben von Werten von einem externen Benutzeroberflächenhandler finden Sie im Thema Zurückgeben von Werten aus einem externen Benutzeroberflächenhandler .

Hinweis

Der msi.h-Header definiert INSTALLUI_HANDLER als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht Codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung Wert
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. Windows Installer unter Windows Server 2003 oder Windows XP
Zielplattform Windows
Kopfzeile msi.h

Weitere Informationen

MsiSetExternalUI