srv_sendmsg (API Stored procedure estesa)

Importante
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 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, utilizzare srv_wsendmsg anziché srv_sendmsg.

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

Nota 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.