srv_senddone(扩展存储过程 API)

重要说明重要提示

后续版本的 Microsoft 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 网站