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

適用対象:SQL Server

重要

この機能は、 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)