Partager via

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

  • Article

S’applique à : SQL Server

Important

Cette fonctionnalité sera supprimée dans une version future de SQL Server. Évitez d'utiliser cette fonctionnalité dans de nouveaux travaux de développement, et prévoyez de modifier les applications qui utilisent actuellement cette fonctionnalité. Utilisez plutôt l'intégration du CLR.

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.

Niveau de gravité
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.

Retours

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.

Important

Il est préférable d'examiner avec soin 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

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