DS_DOMAIN_CONTROLLER_INFO_1W 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 ...
WCHAR *NetbiosName;
#if ...
WCHAR *DnsHostName;
#if ...
WCHAR *SiteName;
#if ...
WCHAR *ComputerObjectName;
#if ...
WCHAR *ServerObjectName;
#else
LPWSTR NetbiosName;
#endif
#else
LPWSTR DnsHostName;
#endif
#else
LPWSTR SiteName;
#endif
#else
LPWSTR ComputerObjectName;
#endif
#else
LPWSTR ServerObjectName;
#endif
BOOL fIsPdc;
BOOL fDsEnabled;
} DS_DOMAIN_CONTROLLER_INFO_1W, *PDS_DOMAIN_CONTROLLER_INFO_1W;
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 |
See also
Feedback
https://aka.ms/ContentUserFeedback.
Coming soon: Throughout 2024 we will be phasing out GitHub Issues as the feedback mechanism for content and replacing it with a new feedback system. For more information see:Submit and view feedback for