INSTALLUI_HANDLER_RECORD funzione di callback (msi.h)

  • Articolo

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.

Stili della casella di messaggioFlag Significato
MB_ABORTRETRYIGNORE
 La finestra di messaggio contiene i pulsanti Abort, Retry e Ignore .
MB_OK
 La finestra di messaggio contiene il pulsante OK . Questo è il valore predefinito.
MB_OKCANCEL
 La finestra di messaggio contiene i pulsanti OK e Annulla .
MB_RETRYCANCEL
 La finestra di messaggio contiene i pulsanti Ripetizione tentativi e Annulla .
MB_YESNO
 La finestra di messaggio contiene i pulsanti Sì e No .
MB_YESNOCANCEL
 La finestra di messaggio contiene i pulsanti Sì, No e Annulla .
 
Casella di messaggio IconTypesFlag Significato
MB_ICONEXCLAMATION, MB_ICONWARNING
 Viene visualizzato un punto esclamativo nella finestra di messaggio.
MB_ICONINFORMATION, MB_ICONASTERISK
 L'accesso alle informazioni viene visualizzato nella finestra di messaggio.
MB_ICONQUESTION
 Viene visualizzato un punto interrogativo nella finestra di messaggio.
MB_ICONSTOP, MB_ICONERROR, MB_ICONHAND
 Viene visualizzato un segno di arresto nella finestra di messaggio.
 
Pulsanti predefinitiFlag Significato
MB_DEFBUTTON1
 Il primo pulsante è il pulsante predefinito.
MB_DEFBUTTON2
 Il secondo pulsante è il pulsante predefinito.
MB_DEFBUTTON3
 Il terzo pulsante è il pulsante predefinito.
 
Installare i tipi di messaggioFlag Significato
INSTALLMESSAGE_FATALEXIT
 Terminazione prematura
INSTALLMESSAGE_ERROR
 Messaggio di errore formattato
INSTALLMESSAGE_WARNING
 Messaggio di avviso formattato
INSTALLMESSAGE_USER
 Messaggio di richiesta utente.
INSTALLMESSAGE_INFO
 Messaggio informativo per il log
INSTALLMESSAGE_FILESINUSE
 Elenco di file attualmente in uso che devono essere chiusi prima di essere sostituiti
INSTALLMESSAGE_RESOLVESOURCE
 Richiesta per determinare una posizione di origine valida
INSTALLMESSAGE_RMFILESINUSE
 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.
INSTALLMESSAGE_OUTOFDISKSPACE
 Messaggio di spazio su disco insufficiente
INSTALLMESSAGE_ACTIONSTART
 Inizio del messaggio di azione. Questo messaggio include il nome e la descrizione dell'azione.
INSTALLMESSAGE_ACTIONDATA
 Dati formattati associati all'elemento di azione individuale.
INSTALLMESSAGE_PROGRESS
 Informazioni sul misuratore di stato. Questo messaggio include informazioni sulle unità finora e sul numero totale di unità.
INSTALLMESSAGE_COMMONDATA
 Informazioni sulla finestra di dialogo formattate per l'interfaccia utente.
INSTALLMESSAGE_INITIALIZE
 Inviato prima dell'inizializzazione dell'interfaccia utente, nessun dato stringa
INSTALLMESSAGE_TERMINATE
 Inviato dopo la terminazione dell'interfaccia utente, nessun dato stringa
INSTALLMESSAGE_SHOWDIALOG
 Inviato prima di visualizzare la finestra di dialogo o la procedura guidata creata
INSTALLMESSAGE_INSTALLSTART
 Inviato prima dell'installazione del prodotto.
INSTALLMESSAGE_INSTALLEND
 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

 
IDCANCEL
 
IDABORT
 
IDRETRY
 
IDIGNORE
 
IDYES
 
IDNO

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

MsiSetExternalUI

Non supportato in Windows Installer 3.0 e versioni precedenti