srv_sendmsg (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.

Invia un messaggio al client.

Sintassi

  
int srv_sendmsg (  
SRV_PROC *  
srvproc  
,  
int  
msgtype  
,  
DBINT  
msgnum  
,  
DBTINYINT  
class  
,   
DBTINYINT  
state  
,  
DBCHAR *  
rpcname  
,  
int   
rpcnamelen  
,  
DBUSMALLINT  
linenum  
,  
DBCHAR *  
message  
,  
int  
msglen   
);  

Argomenti

srvproc
Puntatore alla struttura SRV_PROC che rappresenta l'handle di una determinata connessione client, in questo caso l'handle che ha ricevuto la richiesta del linguaggio. La struttura contiene informazioni utilizzate dalla libreria dell'API Stored procedure estesa per gestire le comunicazioni e i dati tra l'applicazione e il client.

msgtype
SRV_MSG_INFO o SRV_MSG_ERROR, a seconda che il server invii un messaggio informativo o un messaggio di errore.

msgnum
Numero di messaggio a 4 byte.

class
Specifica la gravità dell'errore. Un livello di gravità minore o uguale a 10 è considerato un messaggio informativo.

state
Fornisce il numero di contesto dell'errore per il messaggio corrente. Il numero di contesto dell'errore fornisce informazioni sul contesto dell'errore. I numeri di contesto validi sono compresi tra 0 e 255.

rpcname
Attualmente non supportato.

rpcnamelen
Attualmente non supportato.

linenum
Numero di riga nel batch di comandi del linguaggio a cui è applicato il messaggio. I numeri di riga partono da 1. Se linenum non si applica al messaggio, viene impostato su 0.

message
Puntatore alla stringa di caratteri da inviare al client.

msglen
Specifica la lunghezza, espressa in byte, di message. Se message è con terminazione Null, impostare msglen su SRV_NULLTERM.

Valori restituiti

SUCCEED o FAIL

Osservazioni:

Questa funzione invia messaggi informativi o di errore al client. Viene chiamata una volta per ogni messaggio da inviare.

I messaggi possono essere inviati al client con srv_sendmsg in qualsiasi ordine prima o dopo l'invio di tutte le righe, se presenti, con srv_sendrow. Tutti i messaggi, se presenti, devono essere inviati al client prima dell'invio dello stato di completamento con srv_senddone.

Per inviare i messaggi in Unicode, usare srv_wsendmsg anziché srv_sendmsg.

Per altre informazioni, vedere Dati Unicode e tabelle codici del server.

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.