INSTALLUI_HANDLERA Rückruffunktion (msi.h)
Der Prototyp der INSTALLUI_HANDLER-Funktion definiert eine Rückruffunktion, die vom Installationsprogramm zur Statusbenachrichtigung und Fehlermeldungen aufgerufen wird. Weitere Informationen zur Verwendung dieses Funktionsprototyps finden Sie im Behandeln von Statusmeldungen mithilfe von MsiSetExternalUI-ein Beispielcodeausschnitt.
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 eines Meldungsfelds, einer Standardschaltfläche und einem Installationsmeldungstyp an. Dieser Parameter muss eine der folgenden Sein:
| Installieren von NachrichtentypenFlag | Bedeutung |
|---|---|
|
Vorzeitige Kündigung |
|
Formatierte Fehlermeldung |
|
Formatierte Warnmeldung |
|
Benutzeranforderungsnachricht. |
|
Informative Nachricht für protokollieren |
|
Liste der derzeit verwendeten Dateien, die vor dem Ersetzen geschlossen werden müssen. |
|
Anforderung zum Ermitteln eines gültigen Quellspeicherorts |
|
Liste der derzeit verwendeten Dateien, die vor dem Ersetzen geschlossen werden müssen. Verfügbar ab Windows Installer 4.0. Weitere Informationen zu dieser Meldung finden Sie unter Using Restart Manager with an External UI. |
|
Meldung "Unzureichender Speicherplatz" |
|
Start der Aktionsnachricht. Diese Nachricht enthält den Aktionsnamen und die Beschreibung. |
|
Formatierte Daten, die dem einzelnen Aktionselement zugeordnet sind. |
|
Statusanzeigeinformationen. Diese Meldung enthält Informationen zu einheiten bis heute und die Gesamtanzahl der Einheiten. |
|
Formatierte Dialogfeldinformationen für die Benutzeroberfläche. |
|
Vor der UI-Initialisierung gesendet, keine Zeichenfolgendaten |
|
Nach Beendigung der Benutzeroberfläche gesendet, keine Zeichenfolgendaten |
|
Vor der Anzeige des erstellten Dialogfelds oder Assistenten gesendet |
|
Vor der Installation des Produkts gesendet. |
|
Nach der Installation des Produkts gesendet. |
Die folgenden Standardwerte sollten verwendet werden, wenn einer der vorherigen Nachrichten fehlt: MB_OK, kein Symbol und MB_DEFBUTTON1. Es gibt keinen Standardmeldungstyp für die Installation. Ein Nachrichtentyp wird immer angegeben.
szMessage
Gibt den Nachrichtentext an.
Rückgabewert
Die folgenden Rückgabewerte werden den schaltflächen zugeordnet, die durch das Nachrichtenfeldformat angegeben werden:
IDOK
Bemerkungen
Weitere Informationen zum Zurückgeben von Werten aus einem externen Benutzeroberflächenhandler finden Sie im Thema Zurückgeben von Werten aus einem externen Benutzeroberflächenhandler Thema.
Anmerkung
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 |
|---|---|
| mindestens unterstützte 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- | Fenster |
| Header- | msi.h |