NetMessageBufferSend 函数 (lmmsg.h)
[从 Windows Vista 开始不支持此函数,因为不支持 Messenger 服务。]
NetMessageBufferSend 函数将信息的缓冲区发送到已注册的消息别名。
语法
NET_API_STATUS NET_API_FUNCTION NetMessageBufferSend(
[in] LPCWSTR servername,
[in] LPCWSTR msgname,
[in] LPCWSTR fromname,
[in] LPBYTE buf,
[in] DWORD buflen
);
parameters
[in] servername
指向常量字符串的指针,该常量字符串指定要在其中执行函数的远程服务器的 DNS 或 NetBIOS 名称。 如果此参数为 NULL,则使用本地计算机。
[in] msgname
指向常量字符串的指针,该常量字符串指定消息缓冲区应发送到的消息别名。
[in] fromname
指向指定消息发件人的常量字符串的指针。 如果此参数为 NULL,则从本地计算机名称发送消息。
[in] buf
指向包含消息文本的缓冲区的指针。 有关详细信息,请参阅 网络管理功能缓冲区。
[in] buflen
指定一个值,该值包含 buf 参数指向的消息文本的长度(以字节为单位)。
返回值
如果函数成功,则返回值NERR_Success。
如果函数失败,则返回值可能是以下错误代码之一。
返回代码 | 说明 |
---|---|
|
调用方没有完成操作的适当访问权限。 |
|
参数不正确。 |
|
不支持此请求。 此错误在 Windows Vista 及更高版本上返回。 |
|
找不到用户名。 |
|
网络硬件中出现常规故障。 |
注解
如果在运行 Active Directory 的域控制器上调用此函数,则会根据安全对象的访问控制列表 (ACL) 允许或拒绝访问。 默认 ACL 仅允许域管理员和帐户操作员调用此函数。 在成员服务器或工作站上,只有管理员和服务器操作员才能调用此函数。 有关详细信息,请参阅 网络管理功能的安全要求。 有关 ACL 和 ACE 的详细信息,请参阅访问控制模型。
要求
最低受支持的客户端 | Windows 2000 Professional [仅限桌面应用] |
最低受支持的服务器 | Windows 2000 Server [仅限桌面应用] |
目标平台 | Windows |
标头 | lmmsg.h (包括 Lm.h) |
Library | Netapi32.lib |
DLL | Netapi32.dll |