Tabella MsiEmbeddedUI

La tabella MsiEmbeddedUI definisce un'interfaccia utente incorporata nel pacchetto di Windows Installer.

Windows Installer 4.0 o versioni precedenti: Non supportato. Questa tabella è disponibile a partire da Windows Installer 4.5.

La tabella MsiEmbeddedUI include le colonne seguenti.

Colonna	Tipo	Chiave	Nullable
MsiEmbeddedUI	Identificatore	S	N
FileName	Text	N	N
Attributi	Integer	N	N
Messagefilter	DoubleInteger	N	S
Dati	Binario	N	N

 

Colonne

MsiEmbeddedUI

Chiave primaria per la tabella.

Filename

Nome del file che riceve le informazioni binarie nella colonna Dati. Il nome del file è necessario per includere un'estensione. Ad esempio, il nome embeddedui.dll è accettabile, ma embeddedui non è accettabile. Il nome può essere localizzato. Questo campo può contenere un nome file breve o un nome di file lungo, ma non può contenere entrambi. Il formato di questo campo è simile al tipo di dati Della colonna Filename , ad eccezione del fatto che il separatore della barra verticale (|) per la sintassi nome file breve/nome file lungo non è disponibile. Poiché alcuni server Web possono fare distinzione tra maiuscole e minuscole, FileName deve corrispondere esattamente al caso dei file di origine per garantire il supporto dei download Internet.

Attributi

Informazioni sui dati nella colonna Dati. Il valore in questo campo può contenere una o più delle costanti seguenti.

Costante	Valore esadecimale	Decimal	Significato
nessuno	0x00	0	Il file non è il file DLL per l'interfaccia utente. Può trattarsi di un file di risorse usato dall'interfaccia utente.
msidbEmbeddedUI	0x01	1	File DLL primario per l'interfaccia utente. Non è possibile contrassegnare più righe della tabella con questo attributo. Se più righe sono contrassegnate con questo attributo, si tratta di un errore e non può essere garantito quale DLL viene usata.
msidbEmbeddedHandlesBasic	0x02	2	Consente al programma di installazione di richiamare l'interfaccia utente incorporata durante un'installazione a livello di interfaccia utente di base. Il programma di installazione ignora questo attributo se non viene combinato con l'attributo msidbEmbeddedUI .

 

Messagefilter

Specifica i tipi di messaggi inviati alla DLL dell'interfaccia utente. Questa colonna è rilevante solo per le righe con l'attributo msidbEmbeddedUI . Questo campo deve essere Null se una riga fa riferimento a un file di risorse e il valore di Attributes è Null. Se una riga fa riferimento a una DLL dell'interfaccia utente, il valore in questa colonna non deve essere Null.

Il valore in questa colonna può essere una combinazione dei valori seguenti. Il programma di installazione ignora tutti gli altri valori.

Costante	Valore esadecimale	Decimal	Descrizione
INSTALLLOGMODE_FATALEXIT	0x00001	1	Terminazione prematura.
INSTALLLOGMODE_ERROR	0x00002	2	Messaggi di errore.
INSTALLLOGMODE_WARNING	0x00004	4	Messaggi di avviso.
INSTALLLOGMODE_USER	0x00008	8	Messaggi utente.
INSTALLLOGMODE_INFO	0x00010	16	Messaggi di stato non registrati.
INSTALLLOGMODE_FILESINUSE	0x00020	32	File attualmente in uso.
INSTALLLOGMODE_RESOLVESOURCE	0x00040	64	Richieste di risoluzione di origine.
INSTALLLOGMODE_OUTOFDISKSPACE	0x00080	128	Messaggi di spazio su disco.
INSTALLLOGMODE_ACTIONSTART	0x00100	256	Messaggi di avvio dell'azione.
INSTALLLOGMODE_ACTIONDATA	0x00200	512	Messaggi di dati azione.
INSTALLLOGMODE_PROGRESS	0x00400	1024	Messaggi di stato.
INSTALLLOGMODE_COMMONDATA	0x00800	2048	Messaggi di inizializzazione dell'interfaccia utente.
INSTALLLOGMODE_INITIALIZE	0x01000	4096	Messaggi di avvio dell'interfaccia utente inviati all'avvio di un'installazione del prodotto.
INSTALLLOGMODE_TERMINATE	0x02000	8192	Messaggi di arresto dell'interfaccia utente inviati al termine dell'installazione di un prodotto.
INSTALLLOGMODE_SHOWDIALOG	0x04000	16384	Messaggi inviati prima della visualizzazione della finestra di dialogo dell'interfaccia utente.
INSTALLLOGMODE_RMFILESINUSE	0x02000000	33554432	I file attualmente contenuti in uso.
INSTALLLOGMODE_INSTALLSTART	0x04000000	67108864	L'installazione del prodotto inizia. Il messaggio contiene il ProductName del prodotto e ProductCode.
INSTALLLOGMODE_INSTALLEND	0x08000000	134217728	L'installazione del prodotto termina. Il messaggio contiene il valore ProductName, ProductCode e restituito del prodotto.

 

Dati

Questa colonna contiene informazioni binarie. Se il campo Attributo è contrassegnato con l'attributo msidbEmbeddedUI , le informazioni in questo campo devono essere una DLL. Se il campo Attributo non è l'attributo msidbEmbededUI , le informazioni in questo campo possono essere un file di risorse in qualsiasi formato.

Commenti

Per usare un'interfaccia utente incorporata, lo sviluppatore di installazione deve creare questa funzionalità nel pacchetto di Windows Installer. La tabella MsiEmbeddedUI definisce l'interfaccia utente incorporata. La DLL per l'interfaccia utente incorporata deve esportare le funzioni InitializeEmbeddedUI, EmbeddedUIHandler e ShutdownEmbeddedUI . I pacchetti che non supportano un'interfaccia utente incorporata possono usare l'interfaccia utente interna di Windows Installer.

Per eseguire gli strumenti di debug per Windows in un'interfaccia utente incorporata, usare le tecniche descritte in Debug di azioni personalizzate. Impostare il valore di MsiBreak su MsiEmbeddedUI.

Per un esempio di interfaccia utente personalizzata incorporata, vedere Uso di un'interfaccia utente incorporata.