Share via

DOMAIN_CONTROLLER_INFO (Compact 2013)

  • Article

3/26/2014

This structure is used with the DsGetDcName function to receive data about a domain controller.

Syntax

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 Embedded Compact only supports DNS-style names, not NetBIOS names.
  • DomainControllerAddressType
    Reserved.
  • 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

Header

dsgetdc.h

See Also

Reference

Domain Discovery Structures
DsGetDcName