MsiEmbeddedUI Table

Tabellen MsiEmbeddedUI definierar ett användargränssnitt som är inbäddat i Windows Installer-paketet.

Windows Installer 4.0 eller tidigare: Stöds inte. Den här tabellen är tillgänglig från och med Windows Installer 4.5.

Tabellen MsiEmbeddedUI innehåller följande kolumner.

Kolumner

MsiEmbeddedUI

Den primära nyckeln för tabellen.

FileName

Namnet på filen som tar emot binär information i kolumnen Data. Namnet på filen krävs för att inkludera ett tillägg. Namnet embeddedui.dll är till exempel acceptabelt, men embeddedui- är oacceptabelt. Namnet kan vara lokaliserat. Det här fältet kan innehålla ett kort filnamn eller ett långt filnamn, men det kan inte innehålla båda. Formatet för det här fältet är som Filnamn kolumndatatyp förutom att den lodräta stapelavgränsaren (|) för det korta filnamnet/den långa filnamnssyntaxen inte är tillgänglig. Eftersom vissa webbservrar kan vara skiftlägeskänsliga bör FileName matcha fallet med källfilerna exakt för att säkerställa stöd för internetnedladdningar.

attribut

Information om data i kolumnen Data. Värdet i det här fältet kan innehålla en eller flera av följande konstanter.

Konstant	Hexadecimal	Decimal	Betydelse
Ingen	0x00	0	Filen är inte DLL-filen för användargränssnittet. Det kan vara en resursfil som används av användargränssnittet.
msidbEmbeddedUI	0x01	1	Den primära DLL-filen för användargränssnittet. Det går inte att markera fler än en rad i tabellen med det här attributet. Om flera rader har markerats med det här attributet är det ett fel och det kan inte garanteras vilken DLL som används.
msidbEmbeddedHandlesBasic	0x02	2	Gör att installationsprogrammet kan anropa det inbäddade användargränssnittet under en grundläggande installation på användargränssnittsnivå. Installationsprogrammet ignorerar det här attributet om det inte kombineras med attributet msidbEmbeddedUI.

 

MessageFilter

Anger vilka typer av meddelanden som skickas till användargränssnittets DLL. Den här kolumnen är endast relevant för rader med attributet msidbEmbeddedUI. Det här fältet ska vara null om en rad refererar till en resursfil och värdet för Attribut är null. Om en rad refererar till en DLL för användargränssnittet ska värdet i den här kolumnen inte vara null.

Värdet i den här kolumnen kan vara en kombination av följande värden. Installationsprogrammet ignorerar alla andra värden.

Konstant	Hexadecimal	Decimal	Beskrivning
INSTALLLOGMODE_FATALEXIT	0x00001	1	För tidig uppsägning.
INSTALLLOGMODE_ERROR	0x00002	2	Felmeddelanden.
INSTALLLOGMODE_WARNING	0x00004	4	Varningsmeddelanden.
INSTALLLOGMODE_USER	0x00008	8	Användarmeddelanden.
INSTALLLOGMODE_INFO	0x00010	16	Statusmeddelanden som inte har loggats.
INSTALLLOGMODE_FILESINUSE	0x00020	32	Filer som för närvarande används.
INSTALLLOGMODE_RESOLVESOURCE	0x00040	64	Källmatchningsbegäranden.
INSTALLLOGMODE_OUTOFDISKSPACE	0x00080	128	Meddelanden om diskutrymme.
INSTALLLOGMODE_ACTIONSTART	0x00100	256	Åtgärdsstartmeddelanden.
INSTALLLOGMODE_ACTIONDATA	0x00200	512	Åtgärdsdatameddelanden.
INSTALLLOGMODE_PROGRESS	0x00400	1024	Förloppsmeddelanden.
INSTALLLOGMODE_COMMONDATA	0x00800	2048	Initieringsmeddelanden för användargränssnittet.
INSTALLLOGMODE_INITIALIZE	0x01000	4096	Startmeddelanden för användargränssnittet skickas när en produktinstallation startas.
INSTALLLOGMODE_TERMINATE	0x02000	8192	Meddelanden om avstängning av användargränssnittet skickas när en produktinstallation har slutförts.
INSTALLLOGMODE_SHOWDIALOG	0x04000	16384	Meddelanden som skickas innan UI-dialogrutan visas.
INSTALLLOGMODE_RMFILESINUSE	0x02000000	33554432	Filer som för närvarande används.
INSTALLLOGMODE_INSTALLSTART	0x04000000	67108864	Installationen av produkten påbörjas. Meddelandet innehåller produktens ProductName och ProductCode.
INSTALLLOGMODE_INSTALLEND	0x08000000	134217728	Installationen av produkten upphör. Meddelandet innehåller produktens ProductName, ProductCode och returvärde.

 

data

Den här kolumnen innehåller binär information. Om fältet Attribut är markerat med attributet msidbEmbeddedUI måste informationen i det här fältet vara en DLL. Om fältet Attribut inte är msidbEmbeddedUI attribut kan informationen i det här fältet vara en resursfil i valfritt format.

Anmärkningar

Om du vill använda ett inbäddat användargränssnitt måste installationsutvecklaren skapa den här funktionen i Windows Installer-paketet. Tabellen MsiEmbeddedUI definierar det inbäddade användargränssnittet. DLL för det inbäddade användargränssnittet bör exportera InitializeEmbeddedUI, EmbeddedUIHandleroch ShutdownEmbeddedUI-funktioner. Paket som inte stöder ett inbäddat användargränssnitt kan använda det interna användargränssnittet för Windows Installer.

Om du vill köra felsökningsverktyg för Windows i ett inbäddat användargränssnitt använder du de tekniker som beskrivs i Felsökning av anpassade åtgärder. Ange värdet för MsiBreak till MsiEmbeddedUI.

Ett exempel på ett inbäddat anpassat användargränssnitt finns i Använda ett inbäddat användargränssnitt.