DOMAIN_CONTROLLER_INFOA 結構 (dsgetdc.h)
DOMAIN_CONTROLLER_INFO 結構會與 DsGetDcName 函式搭配使用，以接收域控制器的相關數據。
語法
typedef struct _DOMAIN_CONTROLLER_INFOA {
LPSTR DomainControllerName;
LPSTR DomainControllerAddress;
ULONG DomainControllerAddressType;
GUID DomainGuid;
LPSTR DomainName;
LPSTR DnsForestName;
ULONG Flags;
LPSTR DcSiteName;
LPSTR ClientSiteName;
} DOMAIN_CONTROLLER_INFOA, *PDOMAIN_CONTROLLER_INFOA;
成員
DomainControllerName
指定所探索域控制器計算機名稱之 Null 終止字串的指標。 傳回的計算機名稱前面加上 “\”。 如果可用，則會傳回 DNS 樣式名稱，例如 「\phoenix.fabrikam.com」。。 如果 DNS 樣式名稱無法使用，則會傳回一般樣式名稱 (“\phoenix”) 。 如果網域是 Windows NT 4.0 網域，或網域不支援 IP 系列的通訊協定，則適用此範例。
DomainControllerAddress
指定所探索域控制器位址之 Null 終止字串的指標。 位址前面加上 “\”。 此字串是 DomainControllerAddressType 成員所定義的其中一種類型。
DomainControllerAddressType
指出 DomainControllerAddress 成員中包含的字串類型。 這可以是下列其中一個值。
DS_INET_ADDRESS
位址是 (字串 IP 位址，例如域控制器的 “\157.55.94.74”) 。
DS_NETBIOS_ADDRESS
位址是域控制器的 NetBIOS 名稱，例如 「\phoenix」。。
DomainGuid
網域的 GUID 。 如果域控制器沒有網域 GUID，則此成員為零;例如，域控制器不是 Windows 2000 域控制器。
DomainName
指定定義域名稱之 Null 終止字串的指標。 如果可用，則會傳回 DNS 樣式名稱，例如 「fabrikam.com」。。 否則會傳回一般樣式的名稱，例如 「fabrikam」。。 如果網域已重新命名，此名稱可能會與要求的功能變數名稱不同。
DnsForestName
以 Null 結尾的字串指標，指定 DS 樹狀結構根目錄的網域名稱。 如果可用，則會傳回 DNS 樣式名稱，例如 「fabrikam.com」。。 否則，會傳回一般樣式的名稱，例如 「fabrikam」。。
Flags
包含描述域控制器的一組旗標。 這可以是零或下列一或多個值的組合。
DS_DNS_CONTROLLER_FLAG
DomainControllerName 成員是 DNS 格式。
DS_DNS_DOMAIN_FLAG
DomainName 成員的格式為 DNS。
DS_DNS_FOREST_FLAG
DnsForestName 成員是 DNS 格式。
DS_CLOSEST_FLAG
域控制器位於與用戶端相同的站臺中。
DS_DS_FLAG
域控制器是網域的目錄服務伺服器。
DS_FULL_SECRET_DOMAIN_6_FLAG
域控制器是 Windows 2008 或更新版本的可寫入域控制器。
DS_GOOD_TIMESERV_FLAG
域控制器正在執行網域的可靠 Windows Time 服務。
DS_GC_FLAG
域控制器是 DnsForestName 所指定樹系的全域編錄伺服器。
DS_KDC_FLAG
域控制器是網域的 Kerberos 金鑰發佈中心。
DS_LDAP_FLAG
伺服器是LDAP伺服器。
DS_NDNC_FLAG
功能變數名稱是應用程式 (非網域) 命名內容。
DS_PDC_FLAG
域控制器是網域的主要域控制器。
DS_SELECT_SECRET_DOMAIN_6_FLAG
域控制器是 Windows 2008 或更新版本的唯讀域控制器。
DS_TIMESERV_FLAG
域控制器正在執行網域的 Windows Time 服務。
DS_WRITABLE_FLAG
域控制器裝載可寫入的目錄服務 (或 SAM) 。
DcSiteName
Null 終止字串的指標，指定域控制器所在的月臺名稱。 如果域控制器不在網站中，此成員可能是 NULL;例如，域控制器是 Windows NT 4.0 域控制器。
ClientSiteName
Null 終止字串的指標，指定計算機所屬的網站名稱。 計算機是在傳遞至 DsGetDcName 的 ComputerName 參數中指定。 如果找不到包含計算機的網站，此成員可能是 NULL ;例如，如果 DS 系統管理員未關聯計算機與有效月臺所在的子網。
備註
注意
dsgetdc.h 標頭會將DOMAIN_CONTROLLER_INFO定義為別名，根據 UNICODE 預處理器常數的定義，自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。 如需詳細資訊，請參閱 函式原型的慣例。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows Vista |
| 最低支援的伺服器 | Windows Server 2008 |
| 標頭 | dsgetdc.h |