dsgetdc.h) (DOMAIN_CONTROLLER_INFOA 结构

项目
08/23/2023

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

地址是 (域控制器的“\157.55.94.74”) 的字符串 IP 地址。

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

通过