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 网站。