Directory Services

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