Sdílet prostřednictvím

Tabulka MsiEmbeddedUI

  • Článek

Tabulka MsiEmbeddedUI definuje uživatelské rozhraní vložené do balíčku Instalační služby systému Windows.

Instalační služba systému Windows 4.0 nebo starší: Nepodporuje se. Tato tabulka je k dispozici od Instalační služby systému Windows 4.5.

Tabulka MsiEmbeddedUI obsahuje následující sloupce.

Sloupec Typ Klíč Nullable
MsiEmbeddedUI identifikátor Y N
Jméno souboru textové N N
Atributy celočíselná N N
MessageFilter doubleInteger N Y
Data binární N N

 

Sloupce

MsiEmbeddedUI

Primární klíč tabulky.

název souboru

Název souboru, který přijímá binární informace ve sloupci Data. Název souboru je nutný k zahrnutí přípony. Název embeddedui.dll je například přijatelný, ale embeddedui je nepřijatelné. Název může být lokalizovaný. Toto pole může obsahovat krátký název souboru nebo dlouhý název souboru, ale nemůže obsahovat obojí. Formát tohoto pole se podobá datovému typu Název souboru sloupci s tím rozdílem, že oddělovač svislého pruhu (|) pro krátkou syntaxi názvu souboru nebo dlouhého názvu souboru není k dispozici. Vzhledem k tomu, že u některých webových serverů se rozlišují malá a velká písmena, soubor FileName by se měl přesně shodovat s případem zdrojových souborů, aby se zajistila podpora stahování z internetu.

atributy

Informace o datech ve sloupci Data Hodnota v tomto poli může obsahovat jednu nebo více následujících konstant.

Konstanta Šestnáctkový Desetinný Význam
Žádný 0x00 0 Soubor není soubor DLL pro uživatelské rozhraní. Může se jednat o soubor prostředků používaný uživatelským rozhraním.
msidbEmbeddedUI 0x01 1 Primární soubor KNIHOVNY DLL pro uživatelské rozhraní. Tento atribut nelze označit více než jedním řádkem v tabulce. Pokud je pomocí tohoto atributu označeno více řádků, jedná se o chybu a nelze zaručit, kterou knihovnu DLL použijete.
msidbEmbeddedHandlesBasic 0x02 2 Umožňuje instalačnímu programu vyvolat vložené uživatelské rozhraní během základní instalace na úrovni uživatelského rozhraní. Instalační program tento atribut ignoruje, pokud není kombinován s atributem msidbEmbeddedUI.

 

MessageFilter

Určuje typy zpráv odesílaných do knihovny DLL uživatelského rozhraní. Tento sloupec je relevantní pouze pro řádky s atributem msidbEmbeddedUI. Toto pole by mělo mít hodnotu null, pokud řádek odkazuje na soubor prostředku a hodnota atributů má hodnotu null. Pokud řádek odkazuje na knihovnu DLL uživatelského rozhraní, hodnota v tomto sloupci by neměla být null.

Hodnota v tomto sloupci může být kombinací následujících hodnot. Instalační program ignoruje všechny ostatní hodnoty.

Konstanta Šestnáctkový Desetinný Popis
INSTALLLOGMODE_FATALEXIT 0x00001 1 Předčasné ukončení.
INSTALLLOGMODE_ERROR 0x00002 2 Chybové zprávy.
INSTALLLOGMODE_WARNING 0x00004 4 Zprávy s upozorněním
INSTALLLOGMODE_USER 0x00008 8 Zprávy uživatelů.
INSTALLLOGMODE_INFO 0x00010 16 Nepřipojení stavových zpráv
INSTALLLOGMODE_FILESINUSE 0x00020 32 Soubory, které se aktuálně používají.
INSTALLLOGMODE_RESOLVESOURCE 0x00040 64 Požadavky na překlad zdrojového kódu
INSTALLLOGMODE_OUTOFDISKSPACE 0x00080 128 Zprávy o místu na disku
INSTALLLOGMODE_ACTIONSTART 0x00100 256 Zprávy o spuštění akce
INSTALLLOGMODE_ACTIONDATA 0x00200 512 Zprávy s daty akcí
INSTALLLOGMODE_PROGRESS 0x00400 1024 Zprávy o průběhu
INSTALLLOGMODE_COMMONDATA 0x00800 2048 Zprávy inicializace uživatelského rozhraní
INSTALLLOGMODE_INITIALIZE 0x01000 4096 Zprávy o spuštění uživatelského rozhraní odeslané při spuštění instalace produktu
INSTALLLOGMODE_TERMINATE 0x02000 8192 Zprávy o vypnutí uživatelského rozhraní odeslané po dokončení instalace produktu
INSTALLLOGMODE_SHOWDIALOG 0x04000 16384 Zprávy odeslané před zobrazením dialogového okna uživatelského rozhraní
INSTALLLOGMODE_RMFILESINUSE 0x02000000 33554432 Soubory, které se aktuálně používají.
INSTALLLOGMODE_INSTALLSTART 0x04000000 67108864 Instalace produktu začíná. Zpráva obsahuje productName a ProductCode produktu.
INSTALLLOGMODE_INSTALLEND 0x08000000 134217728 Instalace produktu končí. Zpráva obsahuje produkt ProductName, ProductCode a návratovou hodnotu.

 

data

Tento sloupec obsahuje binární informace. Pokud je pole Atribut označeno atributem msidbEmbeddedUI, musí být informace v tomto poli knihovna DLL. Pokud pole Atribut není atributem msidbEmbeddedUI, mohou být informace v tomto poli souborem prostředků v libovolném formátu.

Poznámky

Pokud chcete použít vložené uživatelské rozhraní, musí vývojář instalačního programu tuto funkci vytvořit do balíčku Instalační služby systému Windows. Tabulka MsiEmbeddedUI definuje vložené uživatelské rozhraní. Knihovna DLL pro vložené uživatelské rozhraní by měla exportovat InitializeEmbeddedUI, EmbeddedUIHandlera ShutdownEmbeddedUI funkce. Balíčky, které nepodporují vložené uživatelské rozhraní, mohou používat interní uživatelské rozhraní Instalační služby systému Windows.

Chcete-li spustit nástroje pro ladění pro Systém Windows ve vloženém uživatelském rozhraní, použijte techniky popsané v tématu Ladění vlastních akcí. Nastavte hodnotu MsiBreak na MsiEmbeddedUI.

Příklad vloženého vlastního uživatelského rozhraní naleznete v tématu Použití integrovaného uživatelského rozhraní.