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 之前,不能释放为 data 分配的内存

返回

SUCCEED 或 FAIL。

注解

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

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

重要

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

另请参阅

srv_describe(扩展存储过程 API)