NetMessageNameGetInfo 函数 (lmmsg.h)

项目
08/24/2023

[从 Windows Vista 开始不支持此函数，因为不支持 Messenger 服务。]

NetMessageNameGetInfo 函数检索有关消息名称表中特定消息别名的信息。函数要求启动 Messenger 服务。

语法

NET_API_STATUS NET_API_FUNCTION NetMessageNameGetInfo(
  [in]  LPCWSTR servername,
  [in]  LPCWSTR msgname,
  [in]  DWORD   level,
  [out] LPBYTE  *bufptr
);

parameters

[in] servername

指向常量字符串的指针，该常量字符串指定要在其中执行函数的远程服务器的 DNS 或 NetBIOS 名称。如果此参数为 NULL，则使用本地计算机。

[in] msgname

指向常量字符串的指针，该常量字符串指定要为其返回信息的消息别名。

[in] level

指定数据的信息级别。此参数的取值可为下列值之一：

值	含义
0	返回消息别名。 bufptr 参数指向MSG_INFO_0结构。
1	返回消息别名。 bufptr 参数指向MSG_INFO_1结构。此级别存在只是为了兼容性。不支持消息转发。

[out] bufptr

指向接收数据的缓冲区的指针。此数据的格式取决于级别参数的值。此缓冲区由系统分配，必须使用 NetApiBufferFree 函数释放。有关详细信息，请参阅网络管理功能缓冲区和网络管理功能缓冲区长度。

返回值

如果函数成功，则返回值NERR_Success。

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

返回代码	说明
ERROR_ACCESS_DENIED	调用方没有完成操作的适当访问权限。
ERROR_INVALID_LEVEL	为级别参数指定的值无效。
ERROR_INVALID_PARAMETER	参数不正确。
ERROR_NOT_ENOUGH_MEMORY	可用内存不足。
ERROR_NOT_SUPPORTED	不支持此请求。此错误在 Windows Vista 及更高版本上返回。
NERR_NotLocalName	消息别名不在本地计算机上。

注解

只有管理员本地组的成员才能在远程服务器上成功执行 NetMessageNameGetInfo 函数。

若要列出消息名称表中的所有消息别名，可以调用 NetMessageNameEnum 函数。

要求


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