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

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

列のデータの現在のアドレスを指定します。

構文

int srv_setcoldata (
SRV_PROC *
srvproc
,
int 
column
,
void *
data 
);

引数

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

• column
  アドレスを指定している列の番号を示します。列には 1 から始まる番号が割り当てられます。

• data
  列のデータを指すポインタです。別に srv_setcoldata を呼び出して列データを置き換えるか、srv_senddone を呼び出すまでは、data に割り当てたメモリを解放しないでください。

戻り値

SUCCEED または FAIL を返します。

解説

行の各列はあらかじめ srv_describe で定義しておく必要があります。列データのアドレスは、最初は srv_describe で設定されます。列データのアドレスが変わった場合は、データの新しいアドレスを指定するために srv_setcoldata を呼び出してから、変更された各列について改めて srv_setcoldata を呼び出す必要があります。

NULL データを表現するには、srv_setcollen を使用して列の長さを 0 に設定します。これにより、データのアドレスは無視されます。

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

参照

関連項目

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

ヘルプおよび情報

SQL Server 2005 の参考資料の入手