La funzione MsiSetInternalUI abilita l'interfaccia utente interna del programma di installazione. Questa interfaccia utente viene quindi usata per tutte le chiamate successive alle funzioni del programma di installazione generate dall'interfaccia utente in questo processo. Per altre informazioni, vedere Livelli dell'interfaccia utente.
Specifica il livello di complessità dell'interfaccia utente. Questo parametro può avere uno dei valori seguenti.
Valore
Significato
INSTALLUILEVEL_FULL
Interfaccia utente creata con procedure guidate, stato ed errori.
INSTALLUILEVEL_REDUCED
Interfaccia utente creata con finestre di dialogo della procedura guidata eliminate.
INSTALLUILEVEL_BASIC
Semplice stato di avanzamento e gestione degli errori.
INSTALLUILEVEL_DEFAULT
Il programma di installazione sceglie un livello di interfaccia utente appropriato.
INSTALLUILEVEL_NONE
Installazione invisibile all'utente. Ciò include l'eliminazione della richiesta di elevazione dei privilegi anche se necessario. Vedere INSTALLUILEVEL_UACONLY se si vuole che l'utente sia in grado di elevare i privilegi.
INSTALLUILEVEL_ENDDIALOG
Se combinato con un valore precedente, il programma di installazione visualizza una finestra di dialogo modale alla fine di un'installazione riuscita o se si è verificato un errore. Non viene visualizzata alcuna finestra di dialogo se l'utente annulla.
INSTALLUILEVEL_PROGRESSONLY
Se combinato con il valore INSTALLUILEVEL_BASIC , il programma di installazione visualizza finestre di dialogo di stato semplici, ma non visualizza finestre di dialogo modali o finestre di dialogo di errore.
INSTALLUILEVEL_NOCHANGE
Nessuna modifica nel livello dell'interfaccia utente. Tuttavia, se phWnd non è Null, la finestra padre può cambiare.
INSTALLUILEVEL_HIDECANCEL
Se combinato con il valore INSTALLUILEVEL_BASIC , il programma di installazione visualizza finestre di dialogo di stato semplici, ma non visualizza un pulsante Annulla nella finestra di dialogo. Ciò impedisce agli utenti di annullare l'installazione.
INSTALLUILEVEL_SOURCERESONLY
Se questo valore viene combinato con il valore INSTALLUILEVEL_NONE , il programma di installazione visualizza solo le finestre di dialogo utilizzate per la risoluzione di origine. Non vengono visualizzate altre finestre di dialogo. Questo valore non ha effetto se il livello dell'interfaccia utente non è INSTALLUILEVEL_NONE. Viene usato con un'interfaccia utente esterna progettata per gestire tutta l'interfaccia utente, ad eccezione della risoluzione di origine. In questo caso, il programma di installazione gestisce la risoluzione di origine.
INSTALLUILEVEL_UACONLY
Se combinato con il valore di INSTALLUILEVEL_NONE , l'installazione sarà completamente invisibile all'utente, ad eccezione della richiesta di elevazione, se necessario.
[in, out] phWnd
Puntatore a una finestra. Questa finestra diventa il proprietario di qualsiasi interfaccia utente creata. Viene restituito un puntatore al proprietario precedente dell'interfaccia utente. Se questo parametro è Null, il proprietario dell'interfaccia utente non viene modificato.
Valore restituito
Viene restituito il livello dell'interfaccia utente precedente. Se viene passato un valore dwUILevel non valido, viene restituito INSTALLUILEVEL_NOCHANGE .
Commenti
La funzione MsiSetInternalUI è utile quando il programma di installazione deve visualizzare un'interfaccia utente. Ad esempio, se viene installata una funzionalità, ma l'origine è un disco compatto che deve essere inserito, il programma di installazione richiede all'utente il disco compatto. A seconda della natura dell'installazione, l'applicazione potrebbe visualizzare anche indicatori di stato o eseguire query sull'utente per ottenere informazioni.
Quando Msi.dll viene caricato, il livello dell'interfaccia utente è impostato su DEFAULT e il proprietario dell'interfaccia utente è impostato su 0, ovvero il proprietario dell'interfaccia utente iniziale è il desktop.
Requisiti
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. Per informazioni sul Service Pack minimo di Windows richiesto da una versione di Windows Installer, vedere Windows Installer Run-Time Requirements .See the Windows Installer requirements for information about the minimum Windows Service Pack that is required by a Windows Installer version.