Condividi tramite

Tabella MsiEmbeddedUI

  • Articolo

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.