Delen via

MsiEmbeddedUI-tabel

  • Artikel

De tabel MsiEmbeddedUI definieert een gebruikersinterface die is ingesloten in het Windows Installer-pakket.

Windows Installer 4.0 of eerder: Niet ondersteund. Deze tabel is beschikbaar vanaf Windows Installer 4.5.

De tabel MsiEmbeddedUI heeft de volgende kolommen.

Kolom Type Sleutel Null-waarde
MsiEmbeddedUI id- Y N
Bestandsnaam tekst N N
Kenmerken geheel getal N N
MessageFilter DoubleInteger- N Y
Gegevens binaire van N N

 

Kolommen

MsiEmbeddedUI

De primaire sleutel voor de tabel.

FileName

De naam van het bestand dat de binaire informatie in de kolom Gegevens ontvangt. De naam van het bestand is vereist om een extensie op te nemen. De naam embeddedui.dll is bijvoorbeeld acceptabel, maar embeddedui is onaanvaardbaar. De naam kan worden gelokaliseerd. Dit veld kan een korte bestandsnaam of een lange bestandsnaam bevatten, maar kan beide niet bevatten. De indeling van dit veld is net als de bestandsnaam kolomgegevenstype, behalve dat het verticale staafscheidingsteken (|) voor de syntaxis van de korte bestandsnaam/lange bestandsnaam niet beschikbaar is. Omdat sommige webservers hoofdlettergevoelig kunnen zijn, moet FileName exact overeenkomen met het geval van de bronbestanden om ondersteuning van internetdownloads te garanderen.

kenmerken

Informatie over de gegevens in de kolom Gegevens. De waarde in dit veld kan een of meer van de volgende constanten bevatten.

Constant Hexadecimaal Decimaal Betekenis
Geen 0x00 0 Het bestand is niet het DLL-bestand voor de gebruikersinterface. Het kan een resourcebestand zijn dat wordt gebruikt door de gebruikersinterface.
msidbEmbeddedUI- 0x01 1 Het primaire DLL-bestand voor de gebruikersinterface. Er kan niet meer dan één rij in de tabel worden gemarkeerd met dit kenmerk. Als er meerdere rijen zijn gemarkeerd met dit kenmerk, is het een fout en kan niet worden gegarandeerd welke DLL wordt gebruikt.
msidbEmbeddedHandlesBasic- 0x02 2 Hiermee kan het installatieprogramma de ingesloten gebruikersinterface aanroepen tijdens een eenvoudige installatie op gebruikersinterfaceniveau. Het installatieprogramma negeert dit kenmerk als het niet wordt gecombineerd met de msidbEmbeddedUI kenmerk.

 

MessageFilter

Hiermee geeft u de typen berichten op die naar de DLL van de gebruikersinterface worden verzonden. Deze kolom is alleen relevant voor rijen met het kenmerk msidbEmbeddedUI. Dit veld moet null zijn als een rij verwijst naar een resourcebestand en de waarde van Kenmerken null is. Als een rij verwijst naar een DLL van de gebruikersinterface, mag de waarde in deze kolom niet null zijn.

De waarde in deze kolom kan een combinatie zijn van de volgende waarden. Het installatieprogramma negeert eventuele andere waarden.

Constant Hexadecimaal Decimaal Beschrijving
INSTALLLOGMODE_FATALEXIT 0x00001 1 Voortijdige beëindiging.
INSTALLLOGMODE_ERROR 0x00002 2 Foutberichten.
INSTALLLOGMODE_WARNING 0x00004 4 Waarschuwingsberichten.
INSTALLLOGMODE_USER 0x00008 8 Gebruikersberichten.
INSTALLLOGMODE_INFO 0x00010 16 Niet-vastgelegde statusberichten.
INSTALLLOGMODE_FILESINUSE 0x00020 32 Bestanden die momenteel in gebruik zijn.
INSTALLLOGMODE_RESOLVESOURCE 0x00040 64 Aanvragen voor bronomzetting.
INSTALLLOGMODE_OUTOFDISKSPACE 0x00080 128 Schijfruimteberichten.
INSTALLLOGMODE_ACTIONSTART 0x00100 256 Berichten starten met actie.
INSTALLLOGMODE_ACTIONDATA 0x00200 512 Berichten over actiegegevens.
INSTALLLOGMODE_PROGRESS 0x00400 1024 Voortgangsberichten.
INSTALLLOGMODE_COMMONDATA 0x00800 2048 Initialisatieberichten van de gebruikersinterface.
INSTALLLOGMODE_INITIALIZE 0x01000 4096 Opstartberichten van de gebruikersinterface die worden verzonden wanneer een productinstallatie wordt gestart.
INSTALLLOGMODE_TERMINATE 0x02000 8192 Berichten over het afsluiten van de gebruikersinterface die worden verzonden nadat een productinstallatie is voltooid.
INSTALLLOGMODE_SHOWDIALOG 0x04000 16384 Berichten die worden verzonden vóór de weergave van het dialoogvenster UI.
INSTALLLOGMODE_RMFILESINUSE 0x02000000 33554432 Bestanden die momenteel in gebruik zijn.
INSTALLLOGMODE_INSTALLSTART 0x04000000 67108864 De installatie van het product begint. Het bericht bevat de ProductName en ProductCode van het product.
INSTALLLOGMODE_INSTALLEND 0x08000000 134217728 Installatie van producteinden. Het bericht bevat de ProductName, ProductCode en retourwaarde van het product.

 

gegevens

Deze kolom bevat binaire informatie. Als het kenmerkveld is gemarkeerd met de msidbEmbeddedUI kenmerk, moet de informatie in dit veld een DLL zijn. Als het kenmerkveld niet de msidbEmbeddedUI kenmerk is, kan de informatie in dit veld een resourcebestand in elke indeling zijn.

Opmerkingen

Als u een ingesloten gebruikersinterface wilt gebruiken, moet de installatieontwikkelaar deze functionaliteit ontwerpen in het Windows Installer-pakket. De tabel MsiEmbeddedUI definieert de ingesloten gebruikersinterface. Het DLL-bestand voor de ingesloten gebruikersinterface moet de InitializeEmbeddedUI-, EmbeddedUIHandler-en shutdownEmbeddedUI--functies exporteren. Pakketten die geen ondersteuning bieden voor een ingesloten gebruikersinterface, kunnen gebruikmaken van de interne gebruikersinterface van Windows Installer.

Als u Hulpprogramma's voor foutopsporing voor Windows wilt uitvoeren op een ingesloten gebruikersinterface, gebruikt u de technieken die worden beschreven in Aangepaste acties voor foutopsporing. Stel de waarde van MsiBreak in op MsiEmbeddedUI.

Zie Een ingesloten gebruikersinterface gebruikenvoor een voorbeeld van een ingesloten aangepaste gebruikersinterface.