Metodo Session.Message
Il metodo Message dell'oggetto Session esegue qualsiasi operazione di registrazione abilitata e rinvia l'esecuzione all'oggetto gestore dell'interfaccia utente associato al motore. La registrazione può essere abilitata in modo selettivo per i vari tipi di messaggio. Vedere il metodo EnableLog.
Se il campo record 0 contiene una stringa di formattazione, viene usato per formattare i dati negli altri campi. In caso contrario, se il messaggio è un errore, un avviso o un messaggio utente, viene effettuato un tentativo di trovare un modello di messaggio nella tabella Errore per il database corrente usando il numero di errore trovato nel campo 1 del record per i tipi di messaggio e i valori restituiti.
Sintassi
Session.Message(
kind,
record
)
Parametri
-
kind
-
Il parametro kind deve essere uno dei valori seguenti. Per visualizzare una finestra di messaggio con pulsanti e icone push, calcolare il valore di tipo aggiungendo gli stili standard della finestra di messaggio usati da MessageBox e MessageBoxEx a msiMessageTypeError, msiMessageTypeWarning o msiMessageTypeUser. Per altre informazioni, vedere la sezione Osservazioni di seguito.
Costante Significato - msiMessageTypeFatalExit
- &H00000000
Terminazione prematura, possibilmente fatale dalla memoria. - msiMessageTypeError
- &H01000000
Messaggio di errore formattato, [1] è il numero di messaggio nella tabella Errore. - msiMessageTypeWarning
- &H02000000
Messaggio di avviso formattato, [1] è il numero di messaggio nella tabella Errore. - msiMessageTypeUser
- &H03000000
Messaggio di richiesta dell'utente, [1] è il numero di messaggio nella tabella Errore. - msiMessageTypeInfo
- &H04000000
Messaggio informativo per il log, non da visualizzare. - msiMessageTypeFilesInUse
- &H05000000
Elenco di file in uso che devono essere sostituiti. - msiMessageTypeResolveSource
- &H06000000
Richiedere di determinare un percorso di origine valido. - msiMessageTypeOutOfDiskSpace
- &H07000000
Messaggio di spazio su disco insufficiente. - msiMessageTypeActionStart
- &H08000000
Inizio dell'azione, [1] nome azione, [2] descrizione, [3] modello per i messaggi ACTIONDATA. - msiMessageTypeActionData
- &H09000000
Dati delle azioni. I campi record corrispondono al modello del messaggio ACTIONSTART. - msiMessageTypeProgress
- &H0A000000
Informazioni sull'indicatore di stato. Vedere la descrizione dei campi dei record di seguito. - msiMessageTypeCommonData
- &H0B000000
Per abilitare il pulsante Annulla impostare [1] su 2 e [2] su 1.
Per disabilitare il pulsante Annulla impostare [1] su 2 e [2] su 0 -
Registrazione
-
Oggetto Record obbligatorio contenente un campo specifico del messaggio.
Valore restituito
| Costante | Valore |
|---|---|
|
-1 |
|
0 |
|
1 |
|
2 |
|
3 |
|
4 |
|
5 |
|
6 |
|
7 |
Osservazioni:
Campi record messaggio
Di seguito vengono descritte le definizioni dei campi di record quando msiMessageTypeProgress viene passato come tipo di messaggio.
Il campo 1 specifica il tipo del messaggio di stato. Il significato degli altri campi dipende dal valore in questo campo. I valori possibili che possono essere impostati nel campo 1 sono i seguenti.
| Nome messaggio | Valore | Descrizione campo 1 |
|---|---|---|
| MasterReset | 0 | Reimposta l'indicatore di stato e imposta il numero totale previsto di tick nella barra. |
| ActionInfo | 1 | Fornisce informazioni relative ai messaggi di stato da inviare dall'azione corrente. |
| ProgressReport | 2 | Incrementa l'indicatore di stato. |
| ProgressAddition | 3 | Consente a un'azione, ad esempio CustomAction, di aggiungere tick al numero totale previsto di avanzamento della barra di stato. |
Il significato del campo 2 dipende dal valore in Campo 1 come indicato di seguito.
| Valore campo 1 | Descrizione campo 2 |
|---|---|
| 0 | Numero totale previsto di tick nell'indicatore di stato. |
| 1 | Numero di segni di graduazione spostati sulla barra di stato per ogni messaggio ActionData. Questo campo viene ignorato se il campo 3 è 0. |
| 2 | Numero di tick spostati dall'indicatore di stato. |
| 3 | Numero di tick da aggiungere al totale dello stato previsto. |
Il significato del campo 3 dipende dal valore in Campo 1 come indicato di seguito.
| Valore campo 1 | Valore campo 3 | Descrizione campo 3 |
|---|---|---|
| 0 | 0 | Indicatore di stato in avanti (da sinistra a destra) |
| 1 | Barra di stato indietro (da destra a sinistra) | |
| 1 | 0 | L'azione corrente invierà messaggi ProgressReport espliciti. |
| 1 | Incrementare la barra di stato in base al numero di tick specificati nel campo 2 ogni volta che viene inviato un messaggio ActionData. | |
| 2 | Non utilizzato | |
| 3 | Non utilizzato |
Il significato del campo 4 dipende dal valore in Campo 1 come indicato di seguito.
| Valore campo 1 | Campo 4 valore | Descrizione campo 4 |
|---|---|---|
| 0 | 0 | L'esecuzione è in corso. In questo caso, l'interfaccia utente potrebbe calcolare e visualizzare il tempo rimanente. |
| 1 | Creazione dello script di esecuzione. In questo caso, l'interfaccia utente potrebbe visualizzare un messaggio per attendere mentre il programma di installazione termina la preparazione dell'installazione. | |
| 1 | Non utilizzato | |
| 2 | Non utilizzato | |
| 3 | Non utilizzato |
Visualizzazione di finestre di messaggio
Per visualizzare una finestra di messaggio con pulsanti e icone push, calcolare il valore di tipo aggiungendo gli stili standard della finestra di messaggio usati da MessageBox e MessageBoxEx a msiMessageTypeError, msiMessageTypeWarning o msiTypeUser. Le opzioni disponibili per il pulsante push per VBScript sono vbOKOnly (MB_OK), vbOKCancel (MB_OKCANCEL), vbAbortRetryIgnore (MB_ABORTRETRYIGNORE), vbYesNoCancel (MB_YESNOCANCEL), vbYesNo (MB_YESNO) e vbRetryCancel (MB_RETRYCANCEL). Le opzioni dell'icona disponibili per VBScript sono vbCritical (MB_ICONERROR), vbQuestion (MB_ICONQUESTION), vbExclamation (MB_ICONWARNING) e vbInformation (MB_ICONINFORMATION).
Ad esempio, la chiamata seguente invia un messaggio msiMessageTypeError con l'icona vbExclamation e i pulsanti vbYesNo.
Session.Message &H01000034, record
Se un'azione personalizzata chiama il metodo Message , l'azione personalizzata deve essere in grado di gestire un annullamento da parte dell'utente e deve restituire msiDoActionStatusUserExit.
Requisiti
| Requisito | Valore |
|---|---|
| Versione |
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 |
| DLL |
|
| IID |
IID_ISession è definito come 000C109E-0000-0000-C000-0000000000046 |
Commenti e suggerimenti
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedere https://aka.ms/ContentUserFeedback.
Invia e visualizza il feedback per