This structure is used with the DsGetDcName function to receive data about a ___domain controller.
typedef struct _DOMAIN_CONTROLLER_INFO { LPTSTR DomainControllerName; LPTSTR DomainControllerAddress; ULONG DomainControllerAddressType; GUID DomainGuid; LPTSTR DomainName; LPTSTR DnsForestName; ULONG Flags; LPTSTR DcSiteName; LPTSTR ClientSiteName;} DOMAIN_CONTROLLER_INFO, *PDOMAIN_CONTROLLER_INFO;
Members
- DomainControllerName
Pointer to a null-terminated string that specifies the computer name of the discovered ___domain controller. The returned computer name is prefixed with "\\". The DNS-style name, for example, "\\phoenix.fabrikam.com", is returned, if it is available. - DomainControllerAddress
Must be set to NULL because Windows CE only supports DNS-style names, not NetBIOS names. - DomainControllerAddressType
Not supported. Reserved for future use. - DomainGuid
The GUID of the ___domain. This member is zero if the ___domain controller does not have a Domain GUID; for example, the ___domain controller is not a Windows® 2000 ___domain controller.
DomainName
Pointer to a null-terminated string that specifies the name of the ___domain. The DNS-style name, for example, "fabrikam.com", is returned if it is available. Otherwise, the flat-style name, for example, "fabrikam", is returned. This name may be different than the requested ___domain name if the ___domain has been renamed.
DnsForestName
Pointer to a null-terminated string that specifies the name of the ___domain at the root of the DS tree. The DNS-style name, for example, "fabrikam.com", is returned if it is available. Otherwise, the flat-style name, for example, "fabrikam" is returned.
Flags
Contains a set of flags that describe the ___domain controller. This can be zero or a combination of one or more of the following values.
| Value | Meaning |
|---|---|
| DS_DNS_CONTROLLER_FLAG | The DomainControllerName member is in DNS format. |
| DS_DNS_DOMAIN_FLAG | The DomainName member is in DNS format. |
| DS_DNS_FOREST_FLAG | The DnsForestName member is in DNS format. |
| DS_DS_FLAG | The ___domain controller is a directory service server for the ___domain. |
| DS_GC_FLAG | The ___domain controller is a global catalog server for the forest specified by DnsForestName. |
| DS_KDC_FLAG | The ___domain controller is a Kerberos Key Distribution Center for the ___domain. |
| DS_PDC_FLAG | The ___domain controller is the primary ___domain controller of the ___domain. |
| DS_TIMESERV_FLAG | The ___domain controller is running the Windows Time Service for the ___domain. |
| DS_WRITABLE_FLAG | The ___domain controller hosts a writable directory service (or SAM). |
- DcSiteName
Pointer to a null-terminated string that specifies the name of the site where the ___domain controller is located. This member may be NULL if the ___domain controller is not in a site. - ClientSiteName
Pointer to a null-terminated string that specifies the name of the site that the computer belongs to. The computer is specified in the ComputerName parameter passed to DsGetDcName. This member may be NULL if the site that contains the computer cannot be found; for example, if the DS administrator has not associated the subnet that the computer is in with a valid site.
Requirements
OS Versions: Windows CE 5.0 and later.
Header: Dsgetdc.h.
See Also
Send Feedback on this topic to the authors