INSTALLUI_HANDLERA Rückruffunktion (msi.h)
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.
| Installieren der Meldung TypesFlag | Bedeutung |
|---|---|
|
Vorzeitige Beendigung |
|
Formatierte Fehlermeldung |
|
Formatierte Warnmeldung |
|
Benutzeranforderungsnachricht. |
|
Informative Meldung für das Protokoll |
|
Liste der derzeit verwendeten Dateien, die geschlossen werden müssen, bevor sie ersetzt werden. |
|
Anforderung zum Ermitteln eines gültigen Quellspeicherorts |
|
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. |
|
Meldung zu unzureichendem Speicherplatz |
|
Meldung zum Start der Aktion. Diese Meldung enthält den Aktionsnamen und die Beschreibung. |
|
Formatierte Daten, die dem einzelnen Aktionselement zugeordnet sind. |
|
Statusanzeigeinformationen. Diese Meldung enthält Informationen zu den bisherigen Einheiten und der Gesamtzahl der Einheiten. |
|
Formatierte Dialoginformationen für die Benutzeroberfläche. |
|
Vor der Benutzeroberflächeninitialisierung gesendet, keine Zeichenfolgendaten |
|
Nach Beendigung der Benutzeroberfläche gesendet, keine Zeichenfolgendaten |
|
Wird vor der Anzeige des erstellten Dialogfelds oder Assistenten gesendet |
|
Wird vor der Installation des Produkts gesendet. |
|
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
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 |