INSTALLUI_HANDLERA funzione di callback (msi.h)

Articolo
03/05/2024

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 . Questo parametro può essere usato per il controllo degli errori.

iMessageType

Specifica una combinazione di uno stile della 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.

Stili finestra di messaggioFlag	Significato
MB_ABORTRETRYIGNORE	La finestra di messaggio contiene i pulsanti Interrompi, Riprova e Ignora .
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 Riprova 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 .

Icona della finestra di messaggioTipiFlag	Significato
MB_ICONEXCLAMATION, MB_ICONWARNING	Nella finestra di messaggio viene visualizzato un punto esclamativo.
MB_ICONINFORMATION, MB_ICONASTERISK	L'accesso alle informazioni viene visualizzato nella finestra di messaggio.
MB_ICONQUESTION	Nella finestra di messaggio viene visualizzato un punto interrogativo.
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 dell'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 un percorso di origine valido
INSTALLMESSAGE_RMFILESINUSE	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.
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 alla singola voce di azione.
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 della visualizzazione della finestra di dialogo o della 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.

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

IDCANCEL

IDABORT

IDRETRY

IDIGNORE

IDYES

IDNO

Commenti

Per altre informazioni sulla restituzione di valori da un gestore dell'interfaccia utente esterna, vedere l'argomento Returning Values from an External User Interface Handler .

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 che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.

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 in Windows Server 2003 o Windows XP
Piattaforma di destinazione	Windows
Intestazione	msi.h

Vedi anche

MsiSetExternalUI

Share via