Condividi tramite

  • Articolo

srv_wsendmsg (API Stored procedure estesa)

Nota importanteImportante

Questa caratteristica verrà rimossa a partire da una delle prossime versioni di Microsoft SQL Server. Non utilizzare questa caratteristica in un nuovo progetto di sviluppo e modificare non appena possibile le applicazioni in cui è attualmente implementata. Utilizzare invece la funzionalità di integrazione con 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.

  • Severity
    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 msglen non sarà mai uguale a SRV_NULLTERM.

La funzione restituisce FAIL quando:

  • Il valore msglen fornito non è incluso nell'intervallo 0-32242.

  • Il valore msglen fornito è 0 ma il puntatore del messaggio è NULL.

  • Si verifica un errore durante l'invio del messaggio di errore tramite rete.

Nota sulla sicurezzaNota sulla sicurezza

È 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 di protezione, visitare questo sito Web Microsoft.