INSTALLUI_HANDLER_RECORD Rückruffunktion (msi.h)

Artikel
02/29/2024

Der INSTALLUI_HANDLER_RECORD Funktionsprototyp definiert eine Rückruffunktion, die das Installationsprogramm für Statusbenachrichtigungen und Fehlermeldungen aufruft. 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. Verfügbar ab Windows Installer Version 3.1 und höher.

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 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-Version 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.

hRecord

Gibt ein Handle für das Datensatzobjekt an. Informationen zu Datensatzobjekten finden Sie unter Datensatzverarbeitungsfunktionen.

Rückgabewert

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

IDOK

IDCANCEL

IDABORT

IDRETRY

IDIGNORE

IDYES

IDNO

Hinweise

Dieser Typ von externem UI-Handler sollte verwendet werden, wenn bekannt ist, welche Art von Fehlern oder Meldungen der Aufrufer interessiert ist, und den Mehraufwand für die Analyse der Zeichenfolgennachricht vermeiden möchte, die an einen externen Ui-Handler INSTALLUI_HANDLER Typs gesendet wird, aber die relevanten Daten aus Feldern von hRecord abrufen.

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 . Das an den datensatzbasierten externen UI-Handler gesendete hRecord-Objekt 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, die Daten im hRecord-Objekt zu ändern, wird von Windows Installer ignoriert.

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

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

Weitere Informationen

MsiSetExternalUI

Nicht von Windows Installer 3.0 und früher unterstützt

Freigeben über