srv_setcollen (擴充預存程序 API)

重要事項
未來的 Microsoft 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_setcollen 來將它設定為新長度，再呼叫 srv_sendrow。如果是允許 Null 値的資料行，則必須以 desttype 設定為允許 Null 值的資料 (比如 SRVINTN) 來呼叫 srv_describe，而且以設定為 0 的 srv_setcollen 呼叫 len 來指定 Null 資料。零長度的資料不能使用擴充預存程序 API 指定。

請注意，當資料行的資料類型是可變長度時，就不會檢查 len。如果針對固定長度資料行呼叫此函數，此函數會傳回 FAIL。

安全性注意事項
您應該徹底檢閱擴充預存程序的原始程式碼，您也應該先測試編譯過的 DLL，才能將它們安裝在實際執行伺服器上。如需有關安全性檢閱和測試的資訊，請參閱此 Microsoft 網站。

請參閱

參考

srv_describe (擴充預存程序 API)