共用方式為

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

另請參閱

目錄服務結構

DsGetDcName