srv_message_handler (API Stored procedure estesa)

Si applica a: SQL Server

Importante

Questa funzionalità verrà rimossa nelle versioni future di SQL Server. Evitare di usare questa funzionalità in un nuovo progetto di sviluppo e prevedere interventi di modifica nelle applicazioni in cui è attualmente implementata. Usare invece l'integrazione CLR.

Chiama il gestore dei messaggi dell'API Stored procedure estesa installato. Questa funzione viene in genere utilizzata per chiamare Microsoft SQL Server da una stored procedure estesa per registrare un errore (definito dalla stored procedure estesa) nel file di log degli errori di SQL Server o nel registro applicazioni di Microsoft Windows.

Sintassi

  
int srv_message_handler (  
SRV_PROC *  
srvproc  
,  
int  
errornum  
,  
BYTE   
severity  
,  
BYTE  
state  
,  
int  
oserrnum  
,  
char *  
errtext  
,  
int  
errtextlen  
,  
char *  
oserrtext  
,  
int  
oserrtextlen  
);  

Argomenti

srvproc
Puntatore alla struttura SRV_PROC che rappresenta l'handle di una determinata connessione client. Il parametro srvproc contiene informazioni usate per gestire le comunicazioni e i dati tra l'applicazione e il client.

errornum
Numero dell'errore definito dalla stored procedure estesa. Questo numero deve essere compreso tra 50.001 e 2.147.483.647.

severity
Valore di gravità standard di SQL Server per l'errore. Questo numero deve essere compreso tra 0 e 24.

state
Valore dello stato di SQL Server per l'errore.

oserrnum
Numero dell'errore del sistema operativo. Questo argomento viene ignorato.

errtext
Descrizione dell'errore della stored procedure estesa errornum.

errtextlen
Lunghezza della stringa dell'errore della stored procedure estesa errtext.

oserrtext
Descrizione dell'errore del sistema operativo oserrnum. Questo argomento viene ignorato.

oserrtextlen
Lunghezza della stringa dell'errore del sistema operativo oserrtext.

Valori restituiti

SUCCEED o FAIL.

Osservazioni:

La funzione srv_message_handler consente a una stored procedure estesa di integrarsi con le funzionalità centralizzate di registrazione e creazione di report degli errori di SQL Server. Gli avvisi di SQL Server possono essere stabiliti per gli eventi delle stored procedure estese e SQL Server Agent monitorerà per queste condizioni di avviso.

Se il messaggio di errore è più lungo, viene troncato a 412 byte.

Importante

È necessario esaminare con attenzione il codice sorgente delle stored procedure estese e testare le DLL compilate prima di installarle in un server di produzione. Per informazioni sui test e sull'analisi della sicurezza, visitare questo sito Web Microsoft.