srv_wsendmsg (拡張ストアド プロシージャ API)
適用対象: 
SQL サーバー
重要
この機能は、 SQL Serverの将来のバージョンで削除される予定です。 新規の開発作業ではこの機能を使用しないようにし、現在この機能を使用しているアプリケーションは修正することを検討してください。 代わりに CLR 統合を使用してください。
クライアントに Unicode メッセージを送信します。
構文
int srv_wsendmsg(SRV_PROC *
srvproc
, int
msgnum
, int
severity
, WCHAR *
message
, int
msglen
);
引数
srvproc
特定のクライアント接続のためのハンドルである SRV_PROC 構造体を指すポインターです。 この構造体には、アプリケーションとクライアントの間の通信やデータを管理するために、拡張ストアド プロシージャ API ライブラリで使用する情報が格納されます。
Msgnum
4 バイトのメッセージ番号です。
重大度
エラーの重大度を指定します。 重大度が 10 以下の場合は情報メッセージと見なされ、10 より大きい場合はエラー メッセージと見なされます。
message
クライアントに送信される Unicode 文字列を指すポインターです。
msglen
message の長さを文字数で指定します。
返品
SUCCEED または FAIL。
解説
この関数は、Unicode でメッセージを送信するために使用します。 この関数は srv_sendmsg と似ていますが、送信されるメッセージは DBCHAR 型ではなく WCHAR 型の文字列です。 メッセージの長さはバイト数ではなく文字数で報告され、msglen が SRV_NULLTERM とは等しくならないことに注意してください。
次の場合、この関数は FAIL を返します。
msglen が 0 から 32242 の範囲内にない場合。
msglen が 0 で、メッセージ ポインターが NULL の場合。
ネットワーク経由でエラー メッセージを送信するときにエラーが発生した場合。
重要
拡張ストアド プロシージャのソース コードを十分に確認し、コンパイル済み DLL を、運用サーバーにインストールする前にテストする必要があります。 セキュリティの確認およびテストについて詳しくは、Microsoft の Web サイトをご覧ください。