Freigeben über

MsiEmbeddedUI-Tabelle

  • Artikel

In der MsiEmbeddedUI-Tabelle wird eine Benutzeroberfläche definiert, die in das Windows Installer-Paket eingebettet ist.

Windows Installer 4.0 oder früher: Nicht unterstützt. Diese Tabelle ist ab Windows Installer 4.5 verfügbar.

Die MsiEmbeddedUI-Tabelle enthält die folgenden Spalten.

Spalte Typ Schlüssel Nullwerte zulässig
MsiEmbeddedUI Identifier J N
FileName Text N N
Attribute Integer N N
MessageFilter DoubleInteger N J
Daten Binär (Binary) N N

 

Spalten

MsiEmbeddedUI

Der Primärschlüssel für die Tabelle.

FileName

Der Name der Datei, die die Binärinformationen in der Datenspalte empfängt. Der Name der Datei muss eine Erweiterung enthalten. Beispielsweise ist der Name embeddedui.dll akzeptabel, aber embeddedui ist inakzeptabel. Der Name kann lokalisiert werden. Dieses Feld kann einen kurzen Dateinamen oder einen langen Dateinamen enthalten, nicht jedoch beide Namensvarianten. Das Format dieses Felds ähnelt dem Spaltendatentyp FileName, mit der Ausnahme, dass das Trennzeichen „senkrechter Strich“ (|) für die Syntax des kurzen Dateinamens/langen Dateinamens nicht verfügbar ist. Da bei einigen Webservern gegebenenfalls die Groß-/Kleinschreibung beachtet wird, muss FileName genau mit der Groß-/Kleinschreibung der Quelldateien übereinstimmen, damit die Unterstützung von Internetdownloads gewährleistet ist.

Attributes

Informationen zu den Daten in der Datenspalte. Der Wert in diesem Feld kann mindestens eine der folgenden Konstanten enthalten.

Konstant Hexadezimal Decimal Bedeutung
Keine 0x00 0 Die Datei ist nicht die DLL-Datei für die Benutzeroberfläche. Es kann sich um eine Ressourcendatei handeln, die von der Benutzeroberfläche verwendet wird.
msidbEmbeddedUI 0x01 1 Die primäre DLL-Datei für die Benutzeroberfläche. Mit diesem Attribut kann maximal eine Zeile in der Tabelle markiert werden. Wenn mehrere Zeilen mit diesem Attribut gekennzeichnet sind, handelt es sich um einen Fehler, und es kann nicht garantiert werden, welche DLL verwendet wird.
msidbEmbeddedHandlesBasic 0x02 2 Ermöglicht dem Installationsprogramm das Aufrufen der eingebetteten Benutzeroberfläche während einer einfachen Installation auf Ebene der Benutzeroberfläche. Dieses Attribut wird vom Installationsprogramm ignoriert, wenn es nicht mit dem Attribut msidbEmbeddedUI kombiniert wird.

 

MessageFilter

Gibt die Typen von Nachrichten an, die an die Benutzeroberflächen-DLL gesendet werden. Diese Spalte ist nur für Zeilen mit dem Attribut msidbEmbeddedUI relevant. Dieses Feld muss NULL sein, wenn eine Zeile auf eine Ressourcendatei verweist und der Wert von Attributes NULL ist. Wenn eine Zeile auf eine Benutzeroberflächen-DLL verweist, darf der Wert in dieser Spalte nicht NULL sein.

Der Wert in dieser Spalte kann eine Kombination der folgenden Werte sein. Alle anderen Werte werden vom Installationsprogramm ignoriert.

Konstant Hexadezimal Decimal BESCHREIBUNG
INSTALLLOGMODE_FATALEXIT 0x00001 1 Vorzeitige Beendigung.
INSTALLLOGMODE_ERROR 0x00002 2 Fehlermeldungen
INSTALLLOGMODE_WARNING 0x00004 4 Warnmeldungen.
INSTALLLOGMODE_USER 0x00008 8 Benutzernachrichten.
INSTALLLOGMODE_INFO 0x00010 16 Unprotokollierte Statusmeldungen.
INSTALLLOGMODE_FILESINUSE 0x00020 32 Derzeit verwendete Dateien.
INSTALLLOGMODE_RESOLVESOURCE 0x00040 64 Quellauflösungsanforderungen.
INSTALLLOGMODE_OUTOFDISKSPACE 0x00080 128 Meldungen zum Speicherplatz.
INSTALLLOGMODE_ACTIONSTART 0x00100 256 Aktionsstartmeldungen.
INSTALLLOGMODE_ACTIONDATA 0x00200 512 Aktionsdatenmeldungen.
INSTALLLOGMODE_PROGRESS 0x00400 1024 Fortschrittsmeldungen.
INSTALLLOGMODE_COMMONDATA 0x00800 2048 Benutzeroberflächen-Initialisierungsmeldungen.
INSTALLLOGMODE_INITIALIZE 0x01000 4096 Benutzeroberflächen-Startmeldungen, die beim Starten einer Produktinstallation gesendet werden.
INSTALLLOGMODE_TERMINATE 0x02000 8192 Benutzeroberflächenmeldungen zum Herunterfahren des Systems, die nach Abschluss einer Produktinstallation gesendet werden.
INSTALLLOGMODE_SHOWDIALOG 0x04000 16384 Nachrichten, die vor der Anzeige eines Dialogfelds der Benutzeroberfläche gesendet werden.
INSTALLLOGMODE_RMFILESINUSE 0x02000000 33554432 Derzeit verwendete Dateien.
INSTALLLOGMODE_INSTALLSTART 0x04000000 67108864 Die Installation des Produkts beginnt. Die Meldung enthält die Eigenschaften ProductName und ProductCode des Produkts.
INSTALLLOGMODE_INSTALLEND 0x08000000 134217728 Die Installation des Produkts endet. Die Meldung enthält die Eigenschaften ProductName und ProductCode sowie den Rückgabewert des Produkts.

 

Data

Diese Spalte enthält binäre Informationen. Wenn das Attributfeld mit dem Attribut msidbEmbeddedUI gekennzeichnet ist, müssen die Informationen in diesem Feld eine DLL sein. Wenn das Attributfeld nicht das Attribut msidbEmbeddedUI ist, können die Informationen in diesem Feld eine Ressourcendatei in einem beliebigen Format sein.

Bemerkungen

Damit Sie eine eingebettete Benutzeroberfläche verwenden können, muss der Setupentwickler diese Funktionalität im Windows Installer-Paket erstellen. In der MsiEmbeddedUI-Tabelle wird die eingebettete Benutzeroberfläche definiert. Über die DLL für die eingebettete Benutzeroberfläche sollten die Funktionen InitializeEmbeddedUI, EmbeddedUIHandler und ShutdownEmbeddedUI exportiert werden. Bei Paketen, die keine eingebettete Benutzeroberfläche unterstützen, kann die interne Benutzeroberfläche von Windows Installer verwendet werden.

Verwenden Sie zum Ausführen von Debugtools für Windows auf einer eingebetteten Benutzeroberfläche die unter Debuggen von benutzerdefinierten Aktionen beschriebenen Techniken. Legen Sie den Wert von MsiBreak auf MsiEmbeddedUI fest.

Ein Beispiel für eine eingebettete benutzerdefinierte Benutzeroberfläche finden Sie unter Verwenden einer eingebetteten Benutzeroberfläche.