srv_sendmsg (API de procédure stockée étendue)

Important

Cette fonctionnalité sera supprimée dans une prochaine version de Microsoft SQL Server. Évitez d'utiliser cette fonctionnalité dans de nouveaux travaux de développement, et modifiez dès que possible les applications qui utilisent actuellement cette fonctionnalité. Use CLR integration instead.

Envoie un message au client.

Syntaxe

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

Arguments

• srvproc
  Pointeur vers la structure SRV_PROC qui est le handle d'une connexion cliente particulière (dans ce cas, le handle qui a reçu la demande de langue). La structure contient des informations que la bibliothèque d'API de procédure stockée étendue utilise pour gérer les communications et les données entre l'application et le client.

• msgtype
  SRV_MSG_INFO ou SRV_MSG_ERROR, selon que le serveur envoie un message d'information ou un message d'erreur.

• msgnum
  Numéro du message à 4 octets.

• class
  Spécifie la gravité de l'erreur. Une gravité inférieure ou égale à 10 est considérée comme un message d'information.

• state
  Fournit le numéro d'état de l'erreur pour le message actuel. Le numéro d'état de l'erreur fournit des informations sur le contexte de l'erreur. Les numéros d'état valides sont compris entre 0 et 255.

• rpcname
  Non pris en charge.

• rpcnamelen
  Non pris en charge.

• linenum
  Numéro de ligne dans le lot de commandes du langage auquel le message s'applique. La numérotation des lignes débute à 1. Si linenum ne s'applique pas au message, définissez cette valeur sur 0.

• message
  Pointeur vers la chaîne de caractères à envoyer au client.

• msglen
  Spécifie la longueur, en octets, de message. Si message se termine par le caractère NULL, définissez msglen sur SRV_NULLTERM.

Valeurs retournées

SUCCEED ou FAIL

Notes

Cette fonction envoie des messages d'erreur ou d'information au client. Elle est appelée une fois pour chaque message à envoyer.

Les messages peuvent être envoyés au client avec srv_sendmsg dans n'importe quel ordre avant ou après que toutes les lignes (le cas échéant) ont été envoyées avec srv_sendrow. Tous les messages, s'il en existe, doivent être envoyés au client avant que l'état d'achèvement soit envoyé avec srv_senddone.

Pour envoyer des messages en Unicode, utilisez srv_wsendmsg à la place de srv_sendmsg.

Pour plus d'informations, consultez Données Unicode et pages de codes du serveur.

Remarque relative à la sécurité
Il est recommandé de revoir en détail le code source des procédures stockées étendues et de tester les DLL compilées avant de les installer sur un serveur de production. Pour plus d'informations sur l'examen et les tests de sécurité, consultez ce site Web de Microsoft.