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。
如果函数失败，则返回值可能是以下错误代码之一。
| 返回代码 | 说明 |
|---|---|
|
调用方没有适当的访问权限来完成操作。 |
|
参数不正确。 |
|
不支持此请求。 此错误在 Windows Vista 及更高版本上返回。 |
|
此计算机上已存在消息别名。 有关更多信息，请参见下面的“备注”部分。 |
|
指定的名称已在网络上用作消息别名。 |
|
网络硬件出现常规故障。 |
|
已超出消息别名的最大数目。 |
注解
只有管理员本地组的成员才能在远程服务器上成功执行 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 |