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

適用対象:SQL Server

重要

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

可変長列または NULL 値を許容する列の、現在のデータ長をバイト数で指定します。

構文

  
int srv_setcollen (  
SRV_PROC *  
srvproc  
,  
int   
column  
,  
int  
len   
);  

引数

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

column
データ長を指定している列の番号を示します。 列には 1 から始まる番号が割り当てられます。

len
列データの長さをバイト数で指定します。 長さが 0 である場合、列データの値が NULL であることを示します。

返品

SUCCEED または FAIL。

解説

行の各列は最初に srv_describe で定義する必要があります。 列のデータ長は srv_describe または srv_setcollen の前回呼び出し時に設定されます。 ある行について可変長のデータ (NULL 終端データ) が変化する場合、srv_sendrow を呼び出す前に、srv_setcollen を使用してデータを新しい長さに変更する必要があります。 NULL 値を許容する列では、NULL を許容する SRVINTN などのデータ型に desttype を設定して srv_describe を呼び出してから、len を 0 に設定して srv_setcollen を呼び出すことにより NULL データを指定します。 拡張ストアド プロシージャ API を使用して長さがゼロのデータを指定することはできません。

列データ型が可変長の場合、len の値は確認されません。 固定長の列について呼び出された場合、この関数は FAIL を返します。

重要

拡張ストアド プロシージャのソース コードを十分に確認し、コンパイル済み DLL を、運用サーバーにインストールする前にテストする必要があります。 セキュリティの確認およびテストについて詳しくは、Microsoft の Web サイトをご覧ください。

参照

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