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