Compartilhar via


Função DnsNameCompare_W (windns.h)

A função DnsNameCompare compara dois nomes DNS. Como muitas funções DNS, o tipo de função DnsNameCompare é implementado em várias formas para facilitar a codificação de caracteres diferente. Com base na codificação de caracteres envolvida, use uma das seguintes funções:

  • DnsNameCompare_A (_A para codificação ANSI)
  • DnsNameCompare_W (_W para codificação Unicode)
  • DnsNameCompare_UTF8 (_UTF8 para codificação Unicode)

Sintaxe

BOOL DnsNameCompare_W(
  [in] PCWSTR pName1,
  [in] PCWSTR pName2
);

Parâmetros

[in] pName1

Um ponteiro para uma cadeia de caracteres que representa o primeiro nome DNS do par de comparação.

[in] pName2

Um ponteiro para uma cadeia de caracteres que representa o segundo nome DNS do par de comparação.

Retornar valor

Retornará TRUE se os nomes comparados forem equivalentes, FALSE se não forem.

Comentários

As comparações de nomes não diferenciam maiúsculas de minúsculas e os pontos à direita são ignorados.

Assim como acontece com outras funções de comparação DNS, a função DnsNameCompare considera a codificação diferente como uma indicação imediata de valores diferentes e, como tal, os mesmos nomes com codificação de caracteres diferentes não serão relatados de forma idêntica.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho windns.h
Biblioteca Dnsapi.lib
DLL Dnsapi.dll

Confira também

DNS_RECORD

DnsQuery

DnsRecordCompare

DnsRecordSetCompare