Funzione MsiSetInternalUI (msi.h)

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.

Sintassi

INSTALLUILEVEL MsiSetInternalUI(
  [in]      INSTALLUILEVEL dwUILevel,
  [in, out] HWND           *phWnd
);

Parametri

[in] dwUILevel

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.
Piattaforma di destinazione	Windows
Intestazione	msi.h
Libreria	Msi.lib
DLL	Msi.dll

Vedi anche

Funzioni di interfaccia e registrazione