NetMessageBufferSend 函数 (lmmsg.h)

项目
08/24/2023

[从 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。

如果函数失败，则返回值可能是以下错误代码之一。

返回代码	说明
ERROR_ACCESS_DENIED	调用方没有完成操作的适当访问权限。
ERROR_INVALID_PARAMETER	参数不正确。
ERROR_NOT_SUPPORTED	不支持此请求。此错误在 Windows Vista 及更高版本上返回。
NERR_NameNotFound	找不到用户名。
NERR_NetworkError	网络硬件中出现常规故障。

注解

如果在运行 Active Directory 的域控制器上调用此函数，则会根据安全对象的访问控制列表 (ACL) 允许或拒绝访问。默认 ACL 仅允许域管理员和帐户操作员调用此函数。在成员服务器或工作站上，只有管理员和服务器操作员才能调用此函数。有关详细信息，请参阅网络管理功能的安全要求。有关 ACL 和 ACE 的详细信息，请参阅访问控制模型。

要求


最低受支持的客户端	Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器	Windows 2000 Server [仅限桌面应用]
目标平台	Windows
标头	lmmsg.h (包括 Lm.h)
Library	Netapi32.lib
DLL	Netapi32.dll