DS_DOMAIN_CONTROLLER_INFO_1A structure (ntdsapi.h)
The DS_DOMAIN_CONTROLLER_INFO_1 structure contains data about a domain controller. This structure is returned by the DsGetDomainControllerInfo function.
Syntax
typedef struct {
#if ...
CHAR *NetbiosName;
#if ...
CHAR *DnsHostName;
#if ...
CHAR *SiteName;
#if ...
CHAR *ComputerObjectName;
#if ...
CHAR *ServerObjectName;
#else
LPSTR NetbiosName;
#endif
#else
LPSTR DnsHostName;
#endif
#else
LPSTR SiteName;
#endif
#else
LPSTR ComputerObjectName;
#endif
#else
LPSTR ServerObjectName;
#endif
BOOL fIsPdc;
BOOL fDsEnabled;
} DS_DOMAIN_CONTROLLER_INFO_1A, *PDS_DOMAIN_CONTROLLER_INFO_1A;
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.
Note
The ntdsapi.h header defines DS_DOMAIN_CONTROLLER_INFO_1 as an alias which automatically selects the ANSI or Unicode version of this function based on the definition of the UNICODE preprocessor constant. Mixing usage of the encoding-neutral alias with code that not encoding-neutral can lead to mismatches that result in compilation or runtime errors. For more information, see Conventions for Function Prototypes.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows Vista |
| Minimum supported server | Windows Server 2008 |
| Header | ntdsapi.h |