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_setcollen 必須在呼叫 srv_sendrow 之前，先將它設定為新的長度。 對於允許 Null 值的數據行，srv_describe必須呼叫 desttype 設定為允許 Null 的數據類型，例如 SRVINTN，而 null 數據是藉由呼叫 len 設定為 0 的srv_setcollen來指定。 無法使用擴充預存程式 API 來指定零長度數據。

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

重要

您應該徹底檢閱擴充預存程式的原始程式碼，而且您應該先測試已編譯的 DLL，再於實際執行伺服器上安裝它們。 如需安全性檢閱和測試的相關信息，請參閱此 Microsoft網站。

另請參閱

srv_describe （擴充預存程式 API）