DS_DOMAIN_CONTROLLER_INFO_3A结构（ntdsapi.h）

DS_DOMAIN_CONTROLLER_INFO_3 结构包含有关域控制器的数据。 此结构由 DsGetDomainControllerInfo 函数返回。

语法

typedef struct {
#if ...
  CHAR  *NetbiosName;
#if ...
  CHAR  *DnsHostName;
#if ...
  CHAR  *SiteName;
#if ...
  CHAR  *SiteObjectName;
#if ...
  CHAR  *ComputerObjectName;
#if ...
  CHAR  *ServerObjectName;
#if ...
  CHAR  *NtdsDsaObjectName;
#else
  LPSTR NetbiosName;
#endif
#else
  LPSTR DnsHostName;
#endif
#else
  LPSTR SiteName;
#endif
#else
  LPSTR SiteObjectName;
#endif
#else
  LPSTR ComputerObjectName;
#endif
#else
  LPSTR ServerObjectName;
#endif
#else
  LPSTR NtdsDsaObjectName;
#endif
  BOOL  fIsPdc;
  BOOL  fDsEnabled;
  BOOL  fIsGc;
  BOOL  fIsRodc;
  GUID  SiteObjectGuid;
  GUID  ComputerObjectGuid;
  GUID  ServerObjectGuid;
  GUID  NtdsDsaObjectGuid;
} DS_DOMAIN_CONTROLLER_INFO_3A, *PDS_DOMAIN_CONTROLLER_INFO_3A;

成员

NetbiosName

指向指定域控制器的 NetBIOS 名称的以 null 结尾的字符串的指针。

DnsHostName

指向指定域控制器 DNS 主机名的以 null 结尾的字符串的指针。

SiteName

指向一个以 null 结尾的字符串的指针，该字符串指定域控制器所属的站点。

SiteObjectName

指向以 null 结尾的字符串的指针，该字符串指定域控制器上的站点对象的名称。

ComputerObjectName

指向以 null 结尾的字符串的指针，该字符串指定域控制器上的计算机对象的名称。

ServerObjectName

指向以 null 结尾的字符串的指针，该字符串指定域控制器上的服务器对象的名称。

NtdsDsaObjectName

指向以 null 结尾的字符串的指针，该字符串指定域控制器上的 NTDS DSA 对象的名称。

fIsPdc

一个布尔值，该值指示此域控制器是否为主域控制器。 如果此值 TRUE，则域控制器是主域控制器;否则，域控制器不是主域控制器。

fDsEnabled

一个布尔值，该值指示是否启用域控制器。 如果此值 TRUE，则启用域控制器;否则，它未启用。

fIsGc

一个布尔值，该值指示域控制器是否为全局编录服务器。 如果此值 TRUE，则域控制器是全局编录服务器;否则，它不是全局编录服务器。

fIsRodc

一个布尔值，该值指示域控制器是否为只读域控制器。 如果此值 TRUE，则域控制器是只读域控制器;否则，它不是只读域控制器。

SiteObjectGuid

包含域控制器上站点对象的 GUID。

ComputerObjectGuid

包含域控制器上计算机对象的 GUID。

ServerObjectGuid

包含域控制器上服务器对象的 GUID。

NtdsDsaObjectGuid

包含域控制器上 NTDS DSA 对象的 GUID。

言论

DsGetDomainControllerInfo 函数可以返回此结构的不同版本。 有关详细信息和当前支持的版本列表，请参阅 DsGetDomainControllerInfoInfoLevel 参数。

注意

ntdsapi.h 标头将DS_DOMAIN_CONTROLLER_INFO_3定义为一个别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将中性编码别名与不中性编码的代码混合使用可能会导致编译或运行时错误不匹配。 有关详细信息，请参阅函数原型的 约定。

要求

要求	价值
最低支持的客户端	Windows Vista
支持的最低服务器	Windows Server 2008
标头	ntdsapi.h

另请参阅

域控制器和复制管理结构

DsGetDomainControllerInfo