srv_wsendmsg (API Stored procedure estesa)

  • Articolo

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.

Vedi anche

srv_sendmsg (API Stored procedure estesa)