INSTALLUI_HANDLERW 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 Verarbeiten von Statusmeldungen mithilfe von MsiSetExternalUI.
Syntax
INSTALLUI_HANDLERW InstalluiHandlerw;
int InstalluiHandlerw(
LPVOID pvContext,
UINT iMessageType,
LPCWSTR 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 einer Meldungsfeldart, einem Nachrichtenfeldsymboltyp, einer Standardschaltfläche und einem Installationsmeldungstyp an. Dieser Parameter muss einer der folgenden Parameter sein.
Installieren von NachrichtentypenFlag | 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 |
|
Start der Aktionsmeldung. Diese Nachricht 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 Gesamtanzahl der Einheiten. |
|
Formatierte Dialoginformationen 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 |
|
Wird vor der Installation des Produkts gesendet. |
|
Wird nach der Installation des Produkts gesendet. |
Die folgenden Standardwerte sollten verwendet werden, wenn eine der vorherigen Nachrichten fehlt: MB_OK, kein Symbol und MB_DEFBUTTON1. Es gibt keinen Standardmeldungstyp für die Installation. Es wird immer ein Nachrichtentyp 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 |
Weitere Informationen
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für