NetMessageNameDel 函数 (lmmsg.h)

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

NetMessageNameDel 函数删除消息名称表中的消息别名。函数要求启动信使服务。

语法

NET_API_STATUS NET_API_FUNCTION NetMessageNameDel(
  [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_DelComputerName	不能删除同样是计算机名称的消息别名。
NERR_IncompleteDel	消息别名未从所有网络成功删除。
NERR_NameInUse	消息别名当前正在使用中。请稍后再试。
NERR_NotLocalName	消息别名不在本地计算机上。

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


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