função DnsNameCompare_W (windns.h)

Artigo
01/16/2025

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.

Valor de retorno

Retorna verdadeiro se os nomes comparados forem equivalentes, FALSE se não forem.

Observações

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

Assim como acontece com outras funções de comparação de 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
de cliente com suporte mínimo	Windows 2000 Professional [somente aplicativos da área de trabalho]
servidor com suporte mínimo	Windows 2000 Server [somente aplicativos da área de trabalho]
da Plataforma de Destino	Windows
cabeçalho	windns.h
biblioteca	Dnsapi.lib
de DLL	Dnsapi.dll

Consulte também

DNS_RECORD

DnsQuery

DnsRecordCompare

DnsRecordSetCompare

Compartilhar via