• 项目

srv_wsendmsg（扩展存储过程 API）

重要说明重要提示

后续版本的 Microsoft SQL Server 将删除该功能。 请不要在新的开发工作中使用该功能，并尽快修改当前还在使用该功能的应用程序。请改用 CLR 集成。

向客户端发送 Unicode 消息。

语法

int srv_wsendmsg(SRV_PROC * 
srvproc
, int 
msgnum
, int 
severity
, WCHAR * 
message
, int 
msglen
);

参数

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

  • Msgnum
    4 字节消息编号。

  • Severity
    指定错误严重性。严重性小于或等于 10 将被视为信息性消息；否则为错误消息。

  • message
    指向要发送到客户端的 Unicode 字符串的指针。

  • msglen
    指定 message 的长度（以字符为单位）。

返回值

SUCCEED 或 FAIL。

注释

使用此函数以 Unicode 格式发送消息。这类似于 srv_sendmsg，但是它发送的消息是一个 WCHAR 字符串而不是 DBCHAR 类型的字符串。请注意，以字符而不是字节报告消息长度，而且 msglen 绝不会等于 SRV_NULLTERM。

该函数在以下情况下返回 FAIL：

  • 给定的 msglen 不在 0-32242 范围内。

  • 给定的 msglen 为 0，但消息指针为 NULL。

  • 通过网络发送错误消息时出错。

安全说明安全说明

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