srv_wsendmsg (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 Unicode al client.
Sintassi
int srv_wsendmsg(SRV_PROC *
srvproc
, int
msgnum
, int
severity
, WCHAR *
message
, int
msglen
);
Argomenti
srvproc
Puntatore alla struttura SRV_PROC che rappresenta l'handle di una determinata connessione client. 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.
Msgnum
Numero di messaggio a 4 byte.
Gravità
Specifica la gravità dell'errore. Un livello di gravità minore o uguale a 10 è considerato un messaggio informativo; in caso contrario, è un errore.
message
Puntatore alla stringa Unicode da inviare al client.
msglen
Specifica la lunghezza, espressa in caratteri, di message.
Valori restituiti
SUCCEED o FAIL.
Osservazioni:
Utilizzare questa funzione per inviare messaggi in Unicode. È simile a srv_sendmsg, ma il messaggio che invia è una stringa WCHAR anziché una stringa di tipo DBCHAR. Notare che la lunghezza del messaggio viene riportata in caratteri anziché in byte e che msglen non sarà mai uguale a SRV_NULLTERM.
La funzione restituisce FAIL quando:
Il valore msglen specificato non è incluso nell'intervallo 0-32242.
Il valore msglen specificato è 0 ma il puntatore del messaggio è NULL.
Si verifica un errore durante l'invio del messaggio di errore tramite rete.
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.