NetAddAlternateComputerName 函数 (lmjoin.h)

项目
08/24/2023

NetAddAlternateComputerName 函数添加指定计算机的备用名称。

语法

NET_API_STATUS NET_API_FUNCTION NetAddAlternateComputerName(
  [in, optional] LPCWSTR Server,
  [in]           LPCWSTR AlternateName,
  [in, optional] LPCWSTR DomainAccount,
  [in, optional] LPCWSTR DomainAccountPassword,
  [in]           ULONG   Reserved
);

parameters

[in, optional] Server

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

[in] AlternateName

指向常量字符串的指针，该常量字符串指定要添加的备用名称。此名称必须采用完全限定的 DNS 名称的形式。

[in, optional] DomainAccount

指向常量字符串的指针，该常量字符串指定用于访问 Active Directory 中的 Server 参数中指定的计算机的计算机帐户对象。如果此参数为 NULL，则使用执行此例程的用户的凭据。

如果执行此函数的服务器未加入域，则不使用此参数。

[in, optional] DomainAccountPassword

指向常量字符串的指针，该常量字符串指定与 DomainAccount 参数中传递的域帐户匹配的密码。如果此参数为 NULL，则使用执行此例程的用户的凭据。

如果 DomainAccount 参数为 NULL，则忽略此参数。如果执行此函数的服务器未加入域，则不使用此参数。

[in] Reserved

保留供将来使用。此参数应为 NULL。

返回值

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

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

返回代码	说明
ERROR_ACCESS_DENIED	拒绝访问。如果调用方不是目标计算机上的 Administrators 本地组的成员，则返回此错误。
ERROR_INVALID_NAME	名称参数不正确。如果 AlternateName 参数不包含有效名称，则返回此错误。
ERROR_INVALID_PARAMETER	参数不正确。如果 DomainAccount 参数不包含有效域，则返回此错误。如果 DomainAccount 参数不为 NULL 且 DomainAccountPassword 参数不为 NULL ，但不包含 Unicode 字符串，也会返回此错误。
ERROR_NOT_ENOUGH_MEMORY	内存不足，无法处理此命令。
ERROR_NOT_SUPPORTED	不支持该请求。如果执行此函数的 Server 参数中指定的目标计算机在 Windows 2000 及更早版本上运行，则返回此错误。
NERR_WkstaNotStarted	工作站服务尚未启动。
RPC_S_CALL_IN_PROGRESS	此线程的远程过程调用已在进行中。
RPC_S_PROTSEQ_NOT_SUPPORTED	不支持远程过程调用协议序列。

注解

Windows XP 及更高版本支持 NetAddAlternateComputerName 函数。

NetAddAlternateComputerName 函数用于设置计算机的辅助网络名称。主名称是用于身份验证的名称，并映射到计算机帐户名称。

NetAddAlternateComputerName 函数要求调用方是目标计算机上的 Administrators 本地组的成员。

要求


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