srv_setcoldata （擴充預存程式 API）

適用於：SQL Server

重要

SQL Server 的未來版本將移除此功能。 請避免在新的開發工作中使用這項功能，並規劃修改目前使用這項功能的應用程式。 請改用 CLR 整合。

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

語法

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

引數

srvproc
這是特定用戶端連接句柄之SRV_PROC結構的指標。 結構包含擴充預存程式 API 連結庫用來管理應用程式和客戶端之間的通訊和資料的資訊。

column
指出所指定地址的數據行數目。 數據行編號從 1 開始。

data
這是數據行數據的指標。 除非數據行數據被另一個呼叫取代為srv_setcoldata，或呼叫srv_senddone，否則不應釋放配置給數據的記憶體。

傳回

SUCCEED 或FAIL。

備註

數據列的每個數據行都必須先使用 srv_describe來定義。 數據行數據位址一開始會設定為 srv_describe。 如果數據行數據的位址變更， 則必須呼叫srv_setcoldata 來指定數據的新位址，而且 必須針對每個已變更的數據行個別呼叫srv_setcoldata 。

Null 資料會藉由使用 srv_setcollen 將數據行的長度設定為 0 來表示。 然後會忽略數據位址。

重要

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

另請參閱

srv_describe （擴充預存程式 API）