共用方式為

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