DnsNameCompare macro (windns.h)

The DnsNameCompare function compares two DNS names. Like many DNS functions, the DnsNameCompare function type is implemented in multiple forms to facilitate different character encoding. Based on the character encoding involved, use one of the following functions:

  • DnsNameCompare_A (_A for ANSI encoding)
  • DnsNameCompare_W (_W for Unicode encoding)
  • DnsNameCompare_UTF8 (_UTF8 for Unicode encoding)

Syntax

void DnsNameCompare(
   n1,
   n2
);

Parameters

n1

TBD

n2

TBD

Return value

None

Remarks

Name comparisons are not case sensitive, and trailing dots are ignored.

As with other DNS comparison functions, the DnsNameCompare function deems different encoding as an immediate indication of differing values, and as such, the same names with different characters encoding will not be reported identically.

Requirements

Requirement Value
Minimum supported client Windows 2000 Professional [desktop apps only]
Minimum supported server Windows 2000 Server [desktop apps only]
Target Platform Windows
Header windns.h
Library Dnsapi.lib
DLL Dnsapi.dll

See also

DNS_RECORD

DnsQuery

DnsRecordCompare

DnsRecordSetCompare