srv_wsendmsg (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é. 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.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. |