POLICY_DNS_DOMAIN_INFO structure (lsalookup.h)

The POLICY_DNS_DOMAIN_INFO structure is used to set and query Domain Name System (DNS) information about the primary domain associated with a Policy object. The LsaQueryInformationPolicy and LsaSetInformationPolicy functions use this structure when their InformationClass parameters are set to PolicyDnsDomainInformation.

Syntax

typedef struct _POLICY_DNS_DOMAIN_INFO {
  LSA_UNICODE_STRING Name;
  LSA_UNICODE_STRING DnsDomainName;
  LSA_UNICODE_STRING DnsForestName;
  GUID               DomainGuid;
  PSID               Sid;
} POLICY_DNS_DOMAIN_INFO, *PPOLICY_DNS_DOMAIN_INFO;

Members

Name

An LSA_UNICODE_STRING structure that specifies the name of the primary domain. This is the same as the primary domain name in the POLICY_PRIMARY_DOMAIN_INFO structure.

DnsDomainName

An LSA_UNICODE_STRING structure that specifies the DNS name of the primary domain.

DnsForestName

An LSA_UNICODE_STRING structure that specifies the DNS forest name of the primary domain. This is the DNS name of the domain at the root of the enterprise.

DomainGuid

A GUID structure that contains the GUID of the primary domain.

Sid

Pointer to the SID of the primary domain. This is the same as the primary domain SID in the POLICY_PRIMARY_DOMAIN_INFO structure.

Remarks

The POLICY_DNS_DOMAIN_INFO structure is an extended version of the POLICY_PRIMARY_DOMAIN_INFO structure. Setting POLICY_DNS_DOMAIN_INFO information will overwrite the corresponding values in the POLICY_PRIMARY_DOMAIN_INFO (name and SID), and vice versa.

If the computer associated with the Policy object is not a member of a domain, all structure members except Name are NULL or zero.

Requirements

Requirement Value
Minimum supported client Windows XP [desktop apps only]
Minimum supported server Windows Server 2003 [desktop apps only]
Header lsalookup.h

See also

LSA_UNICODE_STRING

LsaQueryInformationPolicy

LsaSetInformationPolicy

POLICY_INFORMATION_CLASS

POLICY_PRIMARY_DOMAIN_INFO