NetMessageNameAdd 函数 (lmmsg.h)

[自 Windows Vista 起不支持此函数，因为信使服务不受支持。]

NetMessageNameAdd 函数在消息名称表中注册消息别名。函数要求启动信使服务。

语法

NET_API_STATUS NET_API_FUNCTION NetMessageNameAdd(
  [in] LPCWSTR servername,
  [in] LPCWSTR msgname
);

[in] servername

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

[in] msgname

指向常量字符串的指针，该字符串指定要添加的消息别名。字符串的长度不能超过 15 个字符。

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

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

返回代码	说明
ERROR_ACCESS_DENIED	调用方没有适当的访问权限来完成操作。
ERROR_INVALID_PARAMETER	参数不正确。
ERROR_NOT_SUPPORTED	不支持此请求。此错误在 Windows Vista 及更高版本上返回。
NERR_AlreadyExists	此计算机上已存在消息别名。有关更多信息，请参见下面的“备注”部分。
NERR_DuplicateName	指定的名称已在网络上用作消息别名。
NERR_NetworkError	网络硬件出现常规故障。
NERR_TooManyNames	已超出消息别名的最大数目。

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

转发操作标志不再是 LAN 管理器 2 的参数。xNetMessageNameAdd 函数，因为不再支持消息转发。如果 NetMessageNameAdd 函数检测到网络上存在 msgname 的转发版本，该函数将失败并出现错误NERR_Already_Exists。

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