srv_wsendmsg（扩展存储过程 API）

  • 项目

适用于：SQL Server

重要

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

向客户端发送 Unicode 消息。

语法

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

参数

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

Msgnum
4 字节消息编号。

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

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

msglen
指定消息的长度（以字符为单位）。

返回

SUCCEED 或 FAIL。

注解

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

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

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

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

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

重要

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

另请参阅

srv_sendmsg（扩展存储过程 API）