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

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.

Il significato del campo 2 dipende dal valore in Campo 1 come indicato di seguito.

Il significato del campo 3 dipende dal valore in Campo 1 come indicato di seguito.

Il significato del campo 4 dipende dal valore in Campo 1 come indicato di seguito.

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