MsiSetExternalUIRecord-Funktion (msi.h)

Die MsiSetExternalUIRecord-Funktion ermöglicht einen externen Benutzeroberflächenhandler.

Syntax

UINT MsiSetExternalUIRecord(
  [in]            INSTALLUI_HANDLER_RECORD  puiHandler,
  [in]            DWORD                     dwMessageFilter,
  [in]            LPVOID                    pvContext,
  [out, optional] PINSTALLUI_HANDLER_RECORD ppuiPrevHandler
);

Die Parameter

[in] puiHandler

Gibt eine Rückruffunktion an, die der INSTALLUI_HANDLER_RECORD Spezifikation entspricht.

Um den aktuellen externen UI-Handler zu deaktivieren, rufen Sie die Funktion mit diesem Parameter auf einen NULL-Wert auf.

[in] dwMessageFilter

Gibt an, welche Nachrichten mithilfe des externen Nachrichtenhandlers verarbeitet werden sollen. Wenn der externe Handler ein Nicht-Null-Ergebnis zurückgibt, wird diese Nachricht nicht an die Benutzeroberfläche gesendet, sondern die Nachricht wird protokolliert, wenn die Protokollierung aktiviert ist. Weitere Informationen finden Sie unter MsiEnableLog.

[in] pvContext

Ein Zeiger auf einen Anwendungskontext, der an die Rückruffunktion übergeben wird.

Dieser Parameter kann für die Fehlerüberprüfung verwendet werden.

[out, optional] ppuiPrevHandler

Gibt den Zeiger auf die zuvor festgelegte Rückruffunktion zurück, die der INSTALLUI_HANDLER_RECORD Spezifikation entspricht, oder NULL , wenn zuvor kein Rückruf festgelegt wurde.

Rückgabewert

Bemerkungen

Diese Funktion kann nicht aus benutzerdefinierten Aktionen aufgerufen werden.

Der externe UI-Handler, der durch Aufrufen von MsiSetExternalUIRecord aktiviert wird, empfängt Nachrichten im Format eines Record-Objekts. Der externe UI-Handler, der durch Aufrufen von MsiSetExternalUI aktiviert wird, empfängt Nachrichten im Format einer Zeichenfolge. Eine externe Benutzeroberfläche wird immer vor der internen Benutzeroberfläche von Windows Installer aufgerufen. Eine aktivierte, datensatzbasierte externe Benutzeroberfläche wird vor einer zeichenfolgenbasierten externen Benutzeroberfläche aufgerufen. Wenn der datensatzbasierte externe UI-Handler 0 (null) zurückgibt, wird die Nachricht an einen aktivierten Zeichenfolgenbasierten externen UI-Handler gesendet. Wenn der externe UI-Handler einen Wert ungleich Null zurückgibt, wird der interne Windows Installer-UI-Handler unterdrückt, und die Meldungen werden als behandelt betrachtet.

Diese Funktion speichert die von ihr festgelegten externen Benutzeroberflächen. Um den aktuellen externen UI-Handler durch einen vorherigen Handler zu ersetzen, rufen Sie die Funktion auf, und geben Sie die INSTALLUI_HANDLER_RECORD als puiHandler-Parameter und 0 (null) als dwMessageFilter-Parameter an.

Der externe Benutzeroberflächenhandler, auf den der puiHandler-Parameter verweist, verfügt nicht über die vollständige Kontrolle über die externe Benutzeroberfläche, es sei denn , MsiSetInternalUI wird aufgerufen, wobei der dwUILevel-Parameter auf INSTALLUILEVEL_NONE festgelegt ist. Wenn MsiSetInternalUI nicht aufgerufen wird, wird standardmäßig die interne Benutzeroberflächenebene auf INSTALLUILEVEL_BASIC festgelegt. Daher wird jede Nachricht, die vom Handler für die externe Benutzeroberfläche nicht behandelt wird, von Windows Installer behandelt. Die erste "Vorbereitung der Installation. . " Dialogfeld wird immer angezeigt, auch wenn der Handler der externen Benutzeroberfläche alle Nachrichten verarbeitet. MsiSetExternalUI sollte nur von einer Bootstrapping-Anwendung aufgerufen werden. Sie können msiSetExternalUI nicht aus einer benutzerdefinierten Aktion aufrufen.

Um diesen externen UI-Handler zu deaktivieren, rufen Sie MsiSetExternalUIRecord mit einem NULL-Wert für den puiHandler-Parameter auf.

Windows Installer 2.0 und Windows Installer 3.0: Nicht unterstützt. Die MsiSetExternalUIRecord-Funktion ist ab Windows Installer 3.1 verfügbar.

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

Anforderungen

Siehe auch

Schnittstellen- und Protokollierungsfunktionen

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