NetServerComputerNameAdd 函数 (lmserver.h)

项目
08/24/2023

NetServerComputerNameAdd 函数枚举指定服务器处于活动状态的传输，并将模拟的服务器名称绑定到每个传输。

NetServerComputerNameAdd 是一个实用工具函数，它结合了 NetServerTransportEnum 函数和 NetServerTransportAddEx 函数的功能。

语法

NET_API_STATUS NET_API_FUNCTION NetServerComputerNameAdd(
  [in] LMSTR ServerName,
  [in] LMSTR EmulatedDomainName,
  [in] LMSTR EmulatedServerName
);

参数

[in] ServerName

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

[in] EmulatedDomainName

指向字符串的指针，该字符串包含指定服务器在使用 EmulatedServerName 宣布其存在时应使用的域名。此参数是可选的。

[in] EmulatedServerName

指向以 null 结尾的字符串的指针，该字符串包含服务器应开始支持的模拟名称以及 ServerName 参数指定的名称。

返回值

如果函数成功，则返回值NERR_Success。请注意，如果将指定的模拟服务器名称添加到至少一个传输， NetServerComputerNameAdd 会成功。

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

返回代码	说明
ERROR_ACCESS_DENIED	用户无权访问请求的信息。
ERROR_DUP_NAME	网络上存在重复的名称。
ERROR_INVALID_DOMAINNAME	在网络上找不到域名。
ERROR_INVALID_PARAMETER	指定的参数无效。
ERROR_NOT_ENOUGH_MEMORY	可用内存不足。

注解

只有管理员或服务器操作员本地组的成员才能成功执行 NetServerComputerNameAdd 函数。

ServerName 参数指定的服务器继续支持它支持的所有名称，此外，还开始支持通过成功调用 NetServerComputerNameAdd 函数提供的新名称。

当服务器重新启动或重启时，调用 NetServerComputerNameAdd 时，名称模拟将停止。若要停止以前调用 NetServerComputerNameAdd 而设置的名称模拟，而无需重启或重新启动，可以调用 NetServerComputerNameDel 函数。

当系统管理员替换服务器但希望使转换对用户保持透明时，通常会使用 NetServerComputerNameAdd 函数。

示例

下面是对 NetServerComputerNameAdd 函数的调用示例，该函数请求 \Server1 也响应对 \Server2 的请求。

NetServerComputerNameAdd (Server1, NULL, Server2);

要求

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