srv_senddone（扩展存储过程 API）

  • 项目

适用于：SQL Server

重要

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

将结果完成消息发送到客户端。

语法

  
int srv_senddone (  
SRV_PROC *  
srvproc  
,  
DBUSMALLINT   
status  
,  
DBUSMALLINT  
info  
,  
DBINT  
count   
);

参数

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

status
各种 status 标志的 2 字节字段。 通过与 status 标志值一起使用 AND 和 OR 逻辑运算符，可以设置多个标志。 下表列出了可能的 status 标志。

状态标志 说明
SRV_DONE_COUNT count 参数包含有效计数。
SRV_DONE_ERROR 当前客户端命令收到了错误。

info
保留的 2 字节字段。 将该值设置为 0。

count
用于指示当前结果集的计数的 4 字节字段。 如果在 status 字段中设置 SRV_DONE_COUNT 标志，则 count 将保存有效计数。

返回

SUCCEED 或 FAIL

注解

客户端请求会导致服务器执行许多命令和返回许多结果集。 对于每个结果集，srv_senddone 必须将结果完成消息返回到客户端。

count 字段指示受命令影响的行数。 如果 count 字段包含计数，则应在 status 字段中设置 SRV_DONE_COUNT 标志。 客户端通过该设置可区分等于 0 的 count 值和未使用的 count 字段。

请勿从 SRV_CONNECT 处理程序调用 srv_senddone。

重要

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