MsiEmbeddedUI tábla

Az MsiEmbeddedUI tábla meghatározza a Windows Installer-csomagba beágyazott felhasználói felületet.

Windows Installer 4.0 vagy korábbi: Nem támogatott. Ez a táblázat a Windows Installer 4.5-től érhető el.

Az MsiEmbeddedUI tábla a következő oszlopokat tartalmazza.

Oszlopok

MsiEmbeddedUI

A tábla elsődleges kulcsa.

FileName

Annak a fájlnak a neve, amely az Adat oszlopban fogadja a bináris adatokat. A fájl nevének tartalmaznia kell egy bővítményt. A embeddedui.dll név például elfogadható, de embeddedui elfogadhatatlan. A név honosított lehet. Ez a mező tartalmazhat rövid vagy hosszú fájlnevet, de mindkettőt nem. A mező formátuma olyan, mint a Fájlnév oszlop adattípusa, kivéve, hogy a rövid fájlnév/hosszú fájlnév szintaxisának függőleges sávelválasztója (|) nem érhető el. Mivel egyes webkiszolgálók megkülönböztethetik a kis- és nagybetűket, a FileName-nek pontosan meg kell egyeznie a forrásfájlok esetével az internetes letöltések támogatásának biztosítása érdekében.

attribútumok

Az Adatok oszlopban lévő adatokra vonatkozó információk. A mező értéke az alábbi állandók közül egy vagy többet tartalmazhat.

Konstans	Hexadecimális	Tizedes	Jelentés
Egyik sem	0x00	0	A fájl nem a felhasználói felület DLL-fájlja. Ez lehet a felhasználói felület által használt erőforrásfájl.
msidbEmbeddedUI	0x01	1	A felhasználói felület elsődleges DLL-fájlja. A tábla egyetlen sora sem jelölhető meg ezzel az attribútummal. Ha több sor van megjelölve ezzel az attribútummal, az hiba, és nem garantálható, hogy melyik DLL-t használja a rendszer.
msidbEmbeddedHandlesBasic	0x02	2	Lehetővé teszi, hogy a telepítő meghívja a beágyazott felhasználói felületet egy alapszintű felhasználói felületi telepítés során. A telepítő figyelmen kívül hagyja ezt az attribútumot, ha nincs kombinálva az msidbEmbeddedUI attribútummal.

 

MessageFilter

Megadja a felhasználói felület DLL-jének küldött üzenetek típusait. Ez az oszlop csak a msidbEmbeddedUI attribútummal rendelkező sorokra vonatkozik. Ennek a mezőnek null értékűnek kell lennie, ha egy sor egy erőforrásfájlra hivatkozik, és az attribútumok értéke null. Ha egy sor egy felhasználói felület DLL-ére hivatkozik, az oszlop értéke nem lehet null.

Az oszlopban szereplő érték a következő értékek kombinációja lehet. A telepítő figyelmen kívül hagyja a többi értéket.

Konstans	Hexadecimális	Tizedes	Leírás
INSTALLLOGMODE_FATALEXIT	0x00001	1	Korai leállás.
INSTALLLOGMODE_ERROR	0x00002	2	Hibaüzenetek.
INSTALLLOGMODE_WARNING	0x00004	4	Figyelmeztető üzenetek.
INSTALLLOGMODE_USER	0x00008	8	Felhasználói üzenetek.
INSTALLLOGMODE_INFO	0x00010	16	Nem megjelölt állapotüzenetek.
INSTALLLOGMODE_FILESINUSE	0x00020	32	Jelenleg használatban lévő fájlok.
INSTALLLOGMODE_RESOLVESOURCE	0x00040	64	Forrásfeloldási kérelmek.
INSTALLLOGMODE_OUTOFDISKSPACE	0x00080	128	Lemezterület-üzenetek.
INSTALLLOGMODE_ACTIONSTART	0x00100	256	Műveletindító üzenetek.
INSTALLLOGMODE_ACTIONDATA	0x00200	512	Műveletadat-üzenetek.
INSTALLLOGMODE_PROGRESS	0x00400	1024	Folyamatban lévő üzenetek.
INSTALLLOGMODE_COMMONDATA	0x00800	2048	Felhasználói felület inicializálási üzenetei.
INSTALLLOGMODE_INITIALIZE	0x01000	4096	A terméktelepítés indításakor küldött felhasználói felületi indítási üzenetek.
INSTALLLOGMODE_TERMINATE	0x02000	8192	A felhasználói felület leállítja a termék telepítése után küldött üzeneteket.
INSTALLLOGMODE_SHOWDIALOG	0x04000	16384	A felhasználói felület párbeszédpanel megjelenése előtt küldött üzenetek.
INSTALLLOGMODE_RMFILESINUSE	0x02000000	33554432	Jelenleg használatban lévő fájlok.
INSTALLLOGMODE_INSTALLSTART	0x04000000	67108864	Megkezdődik a termék telepítése. Az üzenet a termék ProductName és ProductCode kódját tartalmazza.
INSTALLLOGMODE_INSTALLEND	0x08000000	134217728	A termék végeinek telepítése. Az üzenet tartalmazza a termék ProductName, ProductCode és return értékét.

 

adatok

Ez az oszlop bináris információkat tartalmaz. Ha az Attribútum mező msidbEmbeddedUI attribútummal van megjelölve, a mezőben szereplő információknak DLL-nek kell lenniük. Ha az Attribútum mező nem az msidbEmbeddedUI attribútum, a mező információi bármilyen formátumú erőforrásfájl lehetnek.

Megjegyzések

Beágyazott felhasználói felület használatához a telepítő fejlesztőjének be kell állítania ezt a funkciót a Windows Installer-csomagba. Az MsiEmbeddedUI tábla határozza meg a beágyazott felhasználói felületet. A beágyazott felhasználói felület DLL-jének exportálnia kell az InitializeEmbeddedUI, EmbeddedUIHandlerés ShutdownEmbeddedUI függvényeket. A beágyazott felhasználói felületet nem támogató csomagok használhatják a Windows Installer belső felhasználói felületét.

Ha beágyazott felhasználói felületen szeretné futtatni Windows hibakeresési eszközeit, használja Egyéni műveletek hibakeresésecímű cikkben ismertetett technikákat. Állítsa az MsiBreak értékét MsiEmbeddedUI értékre.

Beágyazott egyéni felhasználói felületre példa: Beágyazott felhasználói felület használata.