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

Article
05/07/2013

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 Unicode au client.

Syntaxe

int srv_wsendmsg(SRV_PROC *  
srvproc 
, int  
msgnum 
, int  
severity 
, WCHAR *  
message 
, int  
msglen 
);

Arguments

srvproc
Pointeur vers la structure SRV_PROC qui est le handle pour une connexion cliente particulière. 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.
Msgnum
Numéro de message à 4 octets.
Severity
Spécifie la gravité de l'erreur. Une gravité inférieure ou égale à 10 est considérée comme un message d'information ; sinon, il s'agit d'une erreur.
message
Pointeur vers une chaîne Unicode à envoyer au client.
msglen
Spécifie la longueur, en caractères, de message.

Valeurs retournées

SUCCEED ou FAIL.

Notes

Utilisez cette fonction pour envoyer des messages en Unicode. Cette fonction est semblable à srv_sendmsg, mais le message qu'elle envoie est une chaîne WCHAR et non une chaîne de type DBCHAR. Notez que la longueur de message est exprimée en caractères et non en octets, et que msglen ne sera jamais égal à SRV_NULLTERM.

Cette fonction retourne FAIL dans les conditions suivantes :

L'argument msglen spécifié n'est pas compris dans la plage 0-32242.
L'argument msglen spécifié est 0 mais le pointeur de message est NULL.
Une erreur se produit lors de l'envoi du message d'erreur par le biais du réseau.

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.

Voir aussi

Référence

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

Partager via