通过

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 时间服务。

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 时间服务。

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