Platform SDK: Active Directory, ADSI, and Directory Services

DS_DOMAIN_CONTROLLER_INFO_1

The DS_DOMAIN_CONTROLLER_INFO_1 structure contains information about a domain controller (DC). This structure is returned by the DsGetDomainControllerInfo function.

typedef struct
{
  LPTSTR NetbiosName;
  LPTSTR DnsHostName;
  LPTSTR SiteName;
  LPTSTR ComputerObjectName;
  LPTSTR ServerObjectName;
  BOOL fIsPdc;
  BOOL fDsEnabled;
} DS_DOMAIN_CONTROLLER_INFO_1, *PDS_DOMAIN_CONTROLLER_INFO_1;

Members

NetbiosName
Pointer to a null-terminated Unicode string specifying the NetBIOS name of the domain controller.
DnsHostName
Pointer to a null-terminated Unicode string specifying the DNS host name of the domain controller.
SiteName
Pointer to a null-terminated Unicode string specifying the site to which the domain controller belongs.
ComputerObjectName
Pointer to a null-terminated Unicode string specifying the name of the computer object on the domain controller.
ServerObjectName
Pointer to a null-terminated Unicode string specifying the name of the server object on the domain controller.
fIsPdc
Boolean value that indicates whether or not this domain controller is the primary domain controller (PDC). If this value is true, the domain controller is the PDC; otherwise, the domain controller is not the PDC.
fDsEnabled
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.

Remarks

The DsGetDomainControllerInfo function can return different versions of this structure. The DS_DOMAIN_CONTROLLER_INFO_1 structure represents version 1 of the structure returned by the DsGetDomainControllerInfo function. Currently, only version 1 is supported.

Requirements

  Windows NT/2000: Requires Windows 2000.
  Header: Declared in Ntdsapi.h.
  Unicode: Declared as Unicode and ANSI structures.

See Also

Domain Controller and Replication Management Structures, DsGetDomainControllerInfo