Funzione MsiSetExternalUIW (msi.h)
La funzione msiSetExternalUI
Sintassi
INSTALLUI_HANDLERW MsiSetExternalUIW(
[in] INSTALLUI_HANDLERW puiHandler,
[in] DWORD dwMessageFilter,
[in] LPVOID pvContext
);
Parametri
[in] puiHandler
Specifica una funzione di callback conforme alla specifica INSTALLUI_HANDLER.
[in] dwMessageFilter
Specifica i messaggi da gestire utilizzando il gestore di messaggi esterni. Se il gestore esterno restituisce un risultato diverso da zero, tale messaggio non verrà inviato all'interfaccia utente, ma verrà registrato se la registrazione è stata abilitata. Per altre informazioni, vedere la funzione msiEnableLog
Valore | Significato |
---|---|
|
File in uso. Quando viene ricevuto questo messaggio, verrà visualizzata una finestra di dialogo FilesInUse. |
|
Chiusura prematura dell'installazione. |
|
Vengono registrati i messaggi di errore. |
|
I messaggi di avviso vengono registrati. |
|
Le richieste utente vengono registrate. |
|
Vengono registrati i messaggi di stato non visualizzati. |
|
Richiedere di determinare un percorso di origine valido. |
|
File in uso. Quando viene ricevuto questo messaggio, deve essere visualizzata una finestra di dialogo msiRMFilesInUse |
|
Spazio su disco insufficiente. |
|
Viene registrato l'inizio delle nuove azioni di installazione. |
|
Il record di dati con l'azione di installazione viene registrato. |
|
I parametri per l'inizializzazione dell'interfaccia utente vengono registrati. |
|
informazioni sull'indicatore di stato. Questo messaggio include informazioni sulle unità finora e sul numero totale di unità. Per una spiegazione del formato del messaggio, vedere la funzione |
|
Se non si tratta di un'installazione non interattiva, la di interfaccia utente di base è stata inizializzata. Se si tratta di un 'installazione completa dell'interfaccia utente, la completa dell'interfaccia utente non è ancora inizializzata. Questo messaggio viene inviato solo a un'interfaccia utente esterna e non viene registrato. |
|
Se viene usata una completa dell'interfaccia utente |
|
Inviato prima della visualizzazione della finestra di dialogo completa dell'interfaccia utente. Questo messaggio viene inviato solo a un'interfaccia utente esterna e non viene registrato. |
|
Viene avviata l'installazione del prodotto.
Il messaggio contiene productName e ProductCode del prodotto. |
|
L'installazione del prodotto termina.
Il messaggio contiene il valore ProductName, ProductCode e return del prodotto. |
[in] pvContext
Puntatore a un contesto dell'applicazione passato alla funzione di callback. Questo parametro può essere usato per il controllo degli errori.
Valore restituito
Il valore restituito è il gestore esterno impostato in precedenza oppure zero (0) se non esiste un gestore impostato in precedenza.
Osservazioni
Per ripristinare il gestore dell'interfaccia utente precedente, viene effettuata una seconda chiamata a MsiSetExternalUI usando il INSTALLUI_HANDLER restituito dalla prima chiamata a MsiSetExternalUI e specificando zero (0) per dwMessageFilter.
Il gestore dell'interfaccia utente esterna a cui punta il parametro
Nota
L'intestazione msi.h definisce MsiSetExternalUI come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.
Fabbisogno
Requisito | Valore |
---|---|
client minimo supportato | Windows Installer 5.0 in Windows Server 2012, Windows 8, Windows Server 2008 R2 o Windows 7. Windows Installer 4.0 o Windows Installer 4.5 in Windows Server 2008 o Windows Vista. Windows Installer in Windows Server 2003 o Windows XP. Per informazioni sul Service Pack minimo di Windows richiesto da una versione di Windows Installer, vedere Requisiti di windows Run-Time. |
piattaforma di destinazione | Finestre |
intestazione |
msi.h |
libreria |
Msi.lib |
dll | Msi.dll |