netGetAnyDCName 函数 (lmaccess.h)

NetGetAnyDCName 函数返回指定服务器直接信任的域 (DC) 的任何域控制器的名称。

支持 DNS 样式名称的应用程序应调用 DsGetDcName 函数。此函数可以查找任何域中的任何 DC，无论指定服务器是否直接信任该域。

语法

NET_API_STATUS NET_API_FUNCTION NetGetAnyDCName(
        LPCWSTR ServerName,
        LPCWSTR DomainName,
        LPBYTE  *Buffer
);

ServerName

指向常量字符串的指针，该常量字符串指定要在其中执行函数的远程服务器的 DNS 或 NetBIOS 名称。如果此参数为 NULL，则使用本地计算机。有关更多信息，请参见下面的“备注”部分。

DomainName

指向指定域名称的常量字符串的指针。如果此参数为 NULL，则使用主域的域控制器名称。有关更多信息，请参见下面的“备注”部分。

Buffer

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

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

返回代码	说明
ERROR_NO_LOGON_SERVERS	找不到域控制器。
ERROR_NO_SUCH_DOMAIN	指定的域不是受信任的域。
ERROR_NO_TRUST_LSA_SECRET	信任关系的客户端已中断。
ERROR_NO_TRUST_SAM_ACCOUNT	信任关系的服务器端中断或密码断开。
ERROR_DOMAIN_TRUST_INCONSISTENT	响应的服务器不是指定域的正确域控制器。

成功执行 NetGetAnyDCName 函数不需要特殊组成员身份。

如果 servername 指定了独立工作站或独立服务器，则没有 域名称 有效。

如果 servername 指定作为域成员的工作站，或指定为域成员的服务器，则 domainname 必须与 servername 位于同一域中。

如果 servername 指定了域控制器，则域名必须是服务器作为控制器的域所信任的域之一。此调用找到的域控制器在此调用期间至少运行了一次。

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