DS_DOMAIN_CONTROLLER_INFO_1

The DS_DOMAIN_CONTROLLER_INFO_1 structure contains data about a domain controller. 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 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.

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.

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.

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

Client: Included in Windows XP and Windows 2000 Professional.
Server: Included in Windows Server 2003 and Windows 2000 Server.
Unicode: Declared as Unicode and ANSI structures.
Header: Declared in Ntdsapi.h.

See Also

DsGetDomainControllerInfo, Domain Controller and Replication Management Structures