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。

如果函式失敗，傳回值可以是下列其中一個錯誤碼。

傳回碼	Description
ERROR_NO_LOGON_SERVERS	找不到域控制器。
ERROR_NO_SUCH_DOMAIN	指定的網域不是受信任的網域。
ERROR_NO_TRUST_LSA_SECRET	信任關係用戶端已中斷。
ERROR_NO_TRUST_SAM_ACCOUNT	信任關係的伺服器端已中斷或密碼中斷。
ERROR_DOMAIN_TRUST_INCONSISTENT	回應的伺服器不是指定網域的適當域控制器。

成功執行 NetGetAnyDCName 函式不需要特殊群組成員資格。

如果 servername 指定獨立工作站或獨立伺服器，則沒有任何 domainname 有效。

如果 servername 指定屬於網域成員的工作站，或是屬於網域成員的伺服器， 則 domainname 必須位於與 servername 相同的網域中。

如果 servername 指定域控制器， 則 domainname 必須是伺服器為控制器之網域信任的其中一個網域。此呼叫找到的域控制器在呼叫期間至少運作一次。