INSTALLUI_HANDLERA funzione di callback (msi.h)
Il prototipo di funzione INSTALLUI_HANDLER definisce una funzione di callback che il programma di installazione chiama per la notifica di stato e i messaggi di errore. Per altre informazioni sull'utilizzo di questo prototipo di funzione, è disponibile un frammento di codice di esempio in Gestione dei messaggi di stato tramite MsiSetExternalUI.
Sintassi
INSTALLUI_HANDLERA InstalluiHandlera;
int InstalluiHandlera(
LPVOID pvContext,
UINT iMessageType,
LPCSTR szMessage
)
{...}
Parametri
pvContext
Puntatore a un contesto dell'applicazione passato alla funzione msiSetExternalUI
iMessageType
Specifica una combinazione di uno stile di finestra di messaggio, un tipo di icona della finestra di messaggio, un pulsante predefinito e un tipo di messaggio di installazione. Questo parametro deve essere uno dei seguenti.
| Installare i tipi di messaggioFlag | Significato |
|---|---|
|
Terminazione prematura |
|
Messaggio di errore formattato |
|
Messaggio di avviso formattato |
|
Messaggio di richiesta dell'utente. |
|
Messaggio informativo per il log |
|
Elenco di file attualmente in uso che devono essere chiusi prima di essere sostituiti. |
|
Richiedere di determinare un percorso di origine valido |
|
Elenco di file attualmente in uso che devono essere chiusi prima di essere sostituiti. Disponibile a partire da Windows Installer 4.0. Per altre informazioni su questo messaggio, vedere Uso di Gestione riavvio con un'interfaccia utente esterna. |
|
Messaggio di spazio su disco insufficiente |
|
Inizio del messaggio di azione. Questo messaggio include il nome e la descrizione dell'azione. |
|
Dati formattati associati all'elemento azione individuale. |
|
Informazioni sul misuratore di stato. Questo messaggio include informazioni sulle unità finora e sul numero totale di unità. |
|
Informazioni sulla finestra di dialogo formattate per l'interfaccia utente. |
|
Inviato prima dell'inizializzazione dell'interfaccia utente, nessun dato stringa |
|
Inviato dopo la terminazione dell'interfaccia utente, nessun dato stringa |
|
Inviato prima della visualizzazione della finestra di dialogo o della procedura guidata creata |
|
Inviato prima dell'installazione del prodotto. |
|
Inviato dopo l'installazione del prodotto. |
Le impostazioni predefinite seguenti devono essere usate se manca uno dei messaggi precedenti: MB_OK, nessuna icona e MB_DEFBUTTON1. Non esiste alcun tipo di messaggio di installazione predefinito; viene sempre specificato un tipo di messaggio.
szMessage
Specifica il testo del messaggio.
Valore restituito
I valori restituiti seguenti eseguono il mapping ai pulsanti specificati dallo stile della finestra di messaggio:
IDOK
Osservazioni
Per altre informazioni sulla restituzione di valori da un gestore dell'interfaccia utente esterna, vedere l'argomento Restituzione di valori da un gestore interfaccia utente esterna.
Nota
L'intestazione msi.h definisce INSTALLUI_HANDLER 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 |
| piattaforma di destinazione | Finestre |
| intestazione |
msi.h |