DS_DOMAIN_CONTROLLER_INFO_3 structure

The DS_DOMAIN_CONTROLLER_INFO_3 structure contains data about a domain controller. This structure is returned by the DsGetDomainControllerInfo function.

Syntax


typedef struct {
  LPTSTR NetbiosName;
  LPTSTR DnsHostName;
  LPTSTR SiteName;
  LPTSTR SiteObjectName;
  LPTSTR ComputerObjectName;
  LPTSTR ServerObjectName;
  LPTSTR NtdsDsaObjectName;
  BOOL   fIsPdc;
  BOOL   fDsEnabled;
  BOOL   fIsGc;
  BOOL   fIsRodc;
  GUID   SiteObjectGuid;
  GUID   ComputerObjectGuid;
  GUID   ServerObjectGuid;
  GUID   NtdsDsaObjectGuid;
} DS_DOMAIN_CONTROLLER_INFO_3, *PDS_DOMAIN_CONTROLLER_INFO_3;

Members

NetbiosName

Pointer to a null-terminated string that specifies the NetBIOS name of the domain controller.

DnsHostName

Pointer to a null-terminated string that specifies the DNS host name of the domain controller.

SiteName

Pointer to a null-terminated string that specifies the site to which the domain controller belongs.

SiteObjectName

Pointer to a null-terminated string that specifies the name of the site object on the domain controller.

ComputerObjectName

Pointer to a null-terminated string that specifies the name of the computer object on the domain controller.

ServerObjectName

Pointer to a null-terminated string that specifies the name of the server object on the domain controller.

NtdsDsaObjectName

Pointer to a null-terminated string that specifies the name of the NTDS DSA object on the domain controller.

fIsPdc

A Boolean value that indicates whether or not this domain controller is the primary domain controller. If this value is TRUE, the domain controller is the primary domain controller; otherwise, the domain controller is not the primary domain controller.

fDsEnabled

A Boolean value that indicates whether or not the domain controller is enabled. If this value is TRUE, the domain controller is enabled; otherwise, it is not enabled.

fIsGc

A Boolean value that indicates whether or not the domain controller is global catalog server. If this value is TRUE, the domain controller is a global catalog server; otherwise, it is not a global catalog server.

fIsRodc

A Boolean value that indicates if the domain controller is a read-only domain controller. If this value is TRUE, the domain controller is a read-only domain controller; otherwise, it is not a read-only domain controller.

SiteObjectGuid

Contains the GUID for the site object on the domain controller.

ComputerObjectGuid

Contains the GUID for the computer object on the domain controller.

ServerObjectGuid

Contains the GUID for the server object on the domain controller.

NtdsDsaObjectGuid

Contains the GUID for the NTDS DSA object on the domain controller.

Remarks

The DsGetDomainControllerInfo function can return different versions of this structure. For more information and a list of the currently supported versions, see the InfoLevel parameter of DsGetDomainControllerInfo.

Requirements

Minimum supported client

Windows Vista

Minimum supported server

Windows Server 2008

Header

Ntdsapi.h

Unicode and ANSI names

DS_DOMAIN_CONTROLLER_INFO_3W (Unicode) and DS_DOMAIN_CONTROLLER_INFO_3A (ANSI)

See also

DsGetDomainControllerInfo
Domain Controller and Replication Management Structures

 

 

Show: