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網站。