srv_wsendmsg (拡張ストアド プロシージャ API)

適用対象:SQL Server

重要

この機能は、 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 サイトをご覧ください。

参照

srv_sendmsg (拡張ストアド プロシージャ API)