srv_setcoldata（扩展存储过程 API）

重要

在 SQL Server的未来版本中将删除此功能。请避免在新的开发工作中使用该功能，并着手修改当前还在使用该功能的应用程序。请改用 CLR 集成。

指定列的数据的当前地址。

语法

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

srvproc
指向作为特定客户端连接句柄的 SRV_PROC 结构的指针。该结构包含扩展存储过程 API 库用于管理应用程序和客户端之间的通信和数据的信息。

column
指示指定其地址的列的编号。列的编号从 1 开始。

data
指向列的数据的指针。在将列数据替换为对 srv_setcoldata 的其他调用或调用 srv_senddone 之前，不能释放为 data 分配的内存。

SUCCEED 或 FAIL。

必须首先使用 srv_describe 定义行的每个列。列数据地址最初使用 srv_describe 进行设置。如果列数据的地址发生更改，则必须调用 srv_setcoldata 以便指定该数据的新地址，并且必须针对更改后的每个列单独调用 srv_setcoldata。

使用 srv_setcollen 将列的长度设置为 0 可以表示 Null 数据。随后将忽略数据地址。

重要

应全面检查扩展存储过程的源代码，并在生产服务器中安装编译的 DLL 之前，对这些 DLL 进行测试。有关安全检查和测试的信息，请访问此 Microsoft 网站。