srv_setcoldata (擴充預存程序 API)

重要事項
未來的 Microsoft SQL Server 版本將移除這項功能。請勿在新的開發工作中使用此功能，並且儘速修改使用此功能的應用程式。 請改用 CLR 整合。

指定資料行資料的目前位址。

語法

int srv_setcoldata (
SRV_PROC *
srvproc
,
int 
column
,
void *
data 
);

引數

• srvproc
  這是指向 SRV_PROC 結構的指標，也是特定用戶端連接的控制代碼。擴充預存程序 API 程式庫會使用該結構所包含的資訊來管理應用程式與用戶端之間的通訊和資料。

• column
  表示指定位址之目標資料行的編號。資料行的編號會從 1 開始。

• data
  這是資料行資料的指標。配置給 data 的記憶體要等到另一個 srv_setcoldata 呼叫取代資料行資料或是呼叫 srv_senddone 之後，才能釋出。

傳回值

SUCCEED 或 FAIL。

備註

資料列的每個資料行都必須先以 srv_describe 定義。資料行資料位址最初是以 srv_describe 設定。如果資料行資料的位址變更了，則必須呼叫 srv_setcoldata 來指定資料的新位址，而且必須針對每一個變更的資料行個別呼叫 srv_setcoldata。

Null 資料的表示方式是使用 srv_setcollen 將資料行的長度設定為 0。然後會忽略資料位址。

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

請參閱

參考

srv_describe (擴充預存程序 API)