2.2.1.2.5 NL_DNS_NAME_INFO

  • Article

The NL_DNS_NAME_INFO structure provides the information on a DNS name (record) (as specified in [RFC2782]) to be updated by the DsrUpdateReadOnlyServerDnsRecords method (section 3.5.4.3.11). DsrUpdateReadOnlyServerDnsRecords method will update DNS as requested by the Register field's value in this structure.

 typedef struct _NL_DNS_NAME_INFO {
   ULONG Type;
   [string] wchar_t* DnsDomainInfo;
   ULONG DnsDomainInfoType;
   ULONG Priority;
   ULONG Weight;
   ULONG Port;
   UCHAR Register;
   ULONG Status;
 } NL_DNS_NAME_INFO,
  *PNL_DNS_NAME_INFO;

Type: The type of DNS name, which MUST be one, and only one, of the following.

Value

Meaning

NlDnsLdapAtSite

22

_ldap._tcp.<SiteName>._sites.<DnsDomainName>.

Allows a client to find an LDAP server in the domain named by <DnsDomainName> and is in the site named by <SiteName>.

NlDnsGcAtSite

25

_ldap._tcp.<SiteName>._sites.gc._msdcs.<DnsForestName>.

Allows a client to find a DC serving a global catalog (GC) in the forest named by <DnsForestName> and is in the site named by <SiteName>.

NlDnsDsaCname

28

<DsaGuid>._msdcs.<DnsForestName>.

Allows a client to find a DC in the forest named by <DnsForestName> based on the DSA GUID. For a definition of DSA GUID, see [MS-ADTS] section 1.1.

NlDnsKdcAtSite

30

_kerberos._tcp.<SiteName>._sites.dc._msdcs.<DnsDomainName>.

Allows a client to find a DC running a Kerberos KDC in the domain named by <DnsDomainName> and is in the site named by <SiteName>.

NlDnsDcAtSite

32

_ldap._tcp.<SiteName>._sites.dc._msdcs.<DnsDomainName>.

Allows a client to find a DC in the domain named by <DnsDomainName> and is in the site named by <SiteName>.

NlDnsRfc1510KdcAtSite

34

_kerberos._tcp.<SiteName>._sites.<DnsDomainName>.

Allows a client to find an RFC-1510 compliant Kerberos KDC in the domain named by <DnsDomainName> and is in the site named by <SiteName>.

NlDnsGenericGcAtSite

36

_gc._tcp.<SiteName>._sites.<DnsForestName>.

Allows a client to find a global catalog (GC) server in the forest named by <DnsForestName> and is in the site named by <SiteName>.

DnsDomainInfo: The string that will be based on the DnsDomainInfoType field defined below.

DnsDomainInfoType: The type of DnsDomainInfo member, which MUST be one, and only one, of the following:

Value

Meaning

NlDnsDomainName

1

The DnsDomainInfo member is a DNS domain name.

NlDnsDomainNameAlias

2

The DnsDomainInfo member is a DNS domain name alias.

NlDnsForestName

3

The DnsDomainInfo member is a DNS forest name.

NlDnsForestNameAlias

4

The DnsDomainInfo member is a DNS forest name alias.

NlDnsNdncDomainName

5

The DnsDomainInfo member is a non-domain NC (application NC) name. For a definition of application NC, see [MS-ADTS] section 1.1.

NlDnsRecordName

6

The DnsDomainInfo member is a DNS record name that is required to be deregistered. This is valid only for deregistration in which the Register value is set to FALSE. For the types of DNS record name, see [MS-ADTS] section 6.3.2.

Priority: The priority for DNS SRV records.

Weight: The weight for DNS SRV records.

Port: The port for the DNS SRV record.

Register: Zero indicates to deregister the DNS name; other values indicate to register the DNS name.

Status: The update status of the DNS name. Status SHOULD<16> be set to 0x00000000 on success; otherwise, it contains a nonzero error code.