INSTALLUI_HANDLER_RECORD funzione di callback (msi.h)
Il prototipo di funzione INSTALLUI_HANDLER_RECORD definisce una funzione di callback che il programma di installazione chiama la notifica di stato e i messaggi di errore. Chiamare la funzione MsiSetExternalUIRecord per abilitare un gestore dell'interfaccia utente esterna di record-base.
Windows Installer 3.0 e Windows Installer 2.0: Non supportato. Disponibile a partire da Windows Installer versione 3.1 e versioni successive.
Sintassi
INSTALLUI_HANDLER_RECORD InstalluiHandlerRecord;
int InstalluiHandlerRecord(
LPVOID pvContext,
UINT iMessageType,
MSIHANDLE hRecord
)
{...}
Parametri
pvContext
Puntatore a un contesto dell'applicazione passato alla funzione MsiSetExternalUIRecord . Questo parametro può essere usato per il controllo degli errori.
iMessageType
Specifica una combinazione di uno stile di una finestra di messaggio, un tipo di icona della casella 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 utente. |
|
Messaggio informativo per il log |
|
Elenco di file attualmente in uso che devono essere chiusi prima di essere sostituiti |
|
Richiesta per determinare una posizione di origine valida |
|
Elenco di file attualmente in uso che devono essere chiusi prima di essere sostituiti. Disponibile a partire da Windows Installer versione 4.0. Per altre informazioni su questo messaggio, vedere Uso di Restart Manager 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 di 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 di visualizzare la finestra di dialogo o la 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.
hRecord
Specifica un handle per l'oggetto record. Per informazioni sugli oggetti record, vedere Funzioni di elaborazione record.
Valore restituito
I valori restituiti seguenti sono mappati ai pulsanti specificati dallo stile della finestra di messaggio:
IDOK
Commenti
Questo tipo di gestore dell'interfaccia utente esterna deve essere usato quando è noto quale tipo di errori o messaggi il chiamante è interessato e vuole evitare il sovraccarico dell'analisi del messaggio stringa inviato a un gestore dell'interfaccia utente esterno di INSTALLUI_HANDLER tipo, ma recuperare i dati di interesse dai campi di hRecord.
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. L'oggetto hRecord inviato al gestore dell'interfaccia utente esterna basato su record è di proprietà di Windows Installer ed è valido solo per la durata del callback. Il callback deve estrarre dal record tutti i dati necessari e non deve chiudere tale handle.
Qualsiasi tentativo da parte di un gestore dell'interfaccia utente esterna basato su record per modificare i dati nell'oggetto hRecord verrà ignorato da Windows Installer.
Per altre informazioni sull'uso di un gestore esterno basato su record, vedere Monitoraggio di un'installazione tramite MsiSetExternalUIRecord.
Requisiti
| 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 3.1 in Windows Server 2003 o Windows XP. |
| Piattaforma di destinazione | Windows |
| Intestazione | msi.h |
Vedi anche
Non supportato in Windows Installer 3.0 e versioni precedenti