Edit

Share via


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