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

重要 :
この機能は、Microsoft SQL Server の将来のバージョンで削除されます。新規の開発作業ではこの機能を使用しないようにし、現在この機能を使用しているアプリケーションはできるだけ早く修正してください。代わりに、CLR 統合を使用してください。

結果完了メッセージをクライアントに送信します。

構文

int srv_senddone (
SRV_PROC *
srvproc
,
DBUSMALLINT 
status
,
DBUSMALLINT
info
,
DBINT
count 
);

引数

• srvproc
  特定のクライアント接続のためのハンドル (この場合は、言語要求を受け取るハンドル) である SRV_PROC 構造体を指すポインタです。この構造体には、アプリケーションとクライアントの間の通信やデータを管理するために、拡張ストアド プロシージャ API ライブラリで使用する情報が格納されます。

• status
  各種の status フラグに使用する 2 バイトのフィールドです。status フラグの値に AND 論理演算子や OR 論理演算子を使用することにより、複数のフラグを設定できます。次の表は、使用可能な status フラグを示しています。

  status フラグ	説明
  SRV_DONE_COUNT	count パラメータに有効なカウントを格納します。
  SRV_DONE_ERROR	現在のクライアント コマンドがエラーを受け取ったことを示します。

• info
  2 バイトの予約フィールドです。この値は 0 に設定します。

• count
  現在の結果セットに対するカウントを示す 4 バイト フィールドです。status フィールドに SRV_DONE_COUNT フラグを設定した場合、count には有効なカウントが格納されます。

戻り値

SUCCEED または FAIL を返します。

解説

サーバーは 1 つのクライアント要求から、複数のコマンドを実行して複数の結果セットを返すことができます。srv_senddone は、各結果セットに対して結果完了メッセージをクライアントに返す必要があります。

count フィールドは、コマンドの影響を受ける行数を示します。count フィールドにカウントが格納されている場合は、status フィールドに SRV_DONE_COUNT フラグを設定する必要があります。この設定により、count の値が 0 であるのか count フィールドが使用されていないのかをクライアントが区別できるようになります。

srv_senddone を SRV_CONNECT ハンドラから呼び出さないでください。

セキュリティ メモ :
拡張ストアド プロシージャのソース コードを十分に確認し、コンパイルした DLL をテストしたうえで実稼働サーバーにインストールしてください。セキュリティの確認およびテストの詳細については、Microsoft の Web サイトを参照してください。