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

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

DnsHostName

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

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