INSTALLUI_HANDLER_RECORD Rückruffunktion (msi.h)

Der prototype INSTALLUI_HANDLER_RECORD-Funktion definiert eine Rückruffunktion, die vom Installer für Statusbenachrichtigungen und Fehlermeldungen aufgerufen wird. Rufen Sie die MsiSetExternalUIRecord-Funktion auf, um einen datensatzbasierten externen Benutzeroberflächenhandler (UI) zu aktivieren.

Windows Installer 3.0 und Windows Installer 2.0: Nicht unterstützt. Ab Windows Installer Version 3.1 und höher verfügbar.

Syntax

INSTALLUI_HANDLER_RECORD InstalluiHandlerRecord;

int InstalluiHandlerRecord(
  LPVOID pvContext,
  UINT iMessageType,
  MSIHANDLE hRecord
)
{...}

Parameter

pvContext

Zeiger auf einen Anwendungskontext, der an die MsiSetExternalUIRecord-Funktion übergeben wird. Dieser Parameter kann zur 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 eine der folgenden Sein.

Nachrichtenfeld FormatvorlagenFlag 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
Ein Ausrufezeichen wird im Meldungsfeld 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
Ein Stoppzeichen wird im Meldungsfeld 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 von NachrichtentypenFlag Bedeutung
INSTALLMESSAGE_FATALEXIT
Vorzeitige Kündigung
INSTALLMESSAGE_ERROR
Formatierte Fehlermeldung
INSTALLMESSAGE_WARNING
Formatierte Warnmeldung
INSTALLMESSAGE_USER
Benutzeranforderungsnachricht.
INSTALLMESSAGE_INFO
Informative Nachricht für protokollieren
INSTALLMESSAGE_FILESINUSE
Liste der aktuell 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 Version 4.0. Weitere Informationen zu dieser Meldung finden Sie unter Verwenden des Neustart-Managers mit einer externen Benutzeroberfläche.
INSTALLMESSAGE_OUTOFDISKSPACE
Unzureichende Meldung zum Speicherplatz
INSTALLMESSAGE_ACTIONSTART
Start der Aktionsnachricht. 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 Einheiten bis heute und gesamter Anzahl von Einheiten.
INSTALLMESSAGE_COMMONDATA
Formatierte Dialogfeldinformationen für die Benutzeroberfläche.
INSTALLMESSAGE_INITIALIZE
Gesendet vor der Ui-Initialisierung, keine Zeichenfolgendaten
INSTALLMESSAGE_TERMINATE
Gesendet nach Beendigung der Benutzeroberfläche, keine Zeichenfolgendaten
INSTALLMESSAGE_SHOWDIALOG
Vor der Anzeige des autorierten Dialogfelds oder Assistenten gesendet
INSTALLMESSAGE_INSTALLSTART
Vor der Installation des Produkts gesendet.
INSTALLMESSAGE_INSTALLEND
Gesendet nach der Installation des Produkts.
 
 

Die folgenden Standardwerte sollten verwendet werden, wenn einer der vorherigen Nachrichten fehlt: MB_OK, kein Symbol und MB_DEFBUTTON1. Es gibt keinen Standardinstallationsmeldungstyp; Ein Nachrichtentyp wird immer angegeben.

hRecord

Gibt einen Handle für das Datensatzobjekt an. Informationen zu Datensatzobjekten finden Sie in den Datensatzverarbeitungsfunktionen.

Rückgabewert

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

IDOK

 
IDCANCEL
 
IDABORT
 
IDRETRY
 
IDIGNORE
 
IDYES
 
IDNO

Hinweise

Dieser Typ externer UI-Handler sollte verwendet werden, wenn bekannt ist, welche Art von Fehlern oder Nachrichten der Aufrufer interessiert ist, und möchte den Aufwand der Analyse der Zeichenfolgennachricht vermeiden, die an einen externen UI-Handler von INSTALLUI_HANDLER Typ gesendet wird, aber die Daten von Interesse aus Feldern von hRecord abrufen.

Weitere Informationen zum Zurückgeben von Werten aus einem externen Benutzeroberflächenhandler finden Sie im Thema zum Zurückgeben von Werten aus einem Thema für externe Benutzeroberflächenhandler . Das hRecord-Objekt, das an den datensatzbasierten externen UI-Handler gesendet wird, gehört windows Installer und ist nur für die Lebensdauer des Rückrufs gültig. Der Rückruf sollte alle benötigten Daten aus dem Datensatz extrahieren und dieses Handle nicht schließen.

Jeder Versuch eines datensatzbasierten externen UI-Handlers zum Ändern der Daten im hRecord-Objekt wird von Windows Installer ignoriert.

Weitere Informationen zur Verwendung eines datensatzbasierten externen Handlers finden Sie unter Überwachen einer Installation mit MsiSetExternalUIRecord.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows Installer 5.0 auf 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 3.1 unter Windows Server 2003 oder Windows XP.
Zielplattform Windows
Kopfzeile msi.h

Weitere Informationen

MsiSetExternalUI

In Windows Installer 3.0 und früheren Versionen nicht unterstützt