Função DnsQueryConfig (windns.h)

Artigo
01/16/2025

A função DnsQueryConfig permite que os programadores de aplicativos consultem a configuração do computador local ou de um adaptador específico.

Sintaxe

DNS_STATUS DnsQueryConfig(
  [in]           DNS_CONFIG_TYPE Config,
  [in]           DWORD           Flag,
  [in, optional] PCWSTR          pwsAdapterName,
  [in, optional] PVOID           pReserved,
  [out]          PVOID           pBuffer,
  [in, out]      PDWORD          pBufLen
);

Parâmetros

[in] Config

Um valor DNS_CONFIG_TYPE que especifica o tipo de configuração das informações a serem consultadas.

[in] Flag

Um valor que especifica se deseja alocar memória para as informações de configuração. Defina de Sinalizador de como DNS_CONFIG_FLAG_ALLOC para alocar memória; caso contrário, defina-o como 0.

Observação Liberar a memória alocada com LocalFree.

[in, optional] pwsAdapterName

Um ponteiro para uma cadeia de caracteres que representa o nome do adaptador no qual a consulta é executada.

[in, optional] pReserved

Reservado para uso futuro.

[out] pBuffer

Um ponteiro para um buffer que recebe a resposta da consulta. A tabela a seguir mostra o tipo de dados do buffer para cada um dos valores de parâmetro de configuração de .

parâmetro de configuração	Tipo de dados do buffer
DnsConfigPrimaryDomainName_W	PWCHAR
DnsConfigPrimaryDomainName_A	PCHAR
DnsConfigPrimaryDomainName_UTF8	PCHAR
DnsConfigAdapterDomainName_W	Não implementado
DnsConfigAdapterDomainName_A	Não implementado
DnsConfigAdapterDomainName_UTF8	Não implementado
DnsConfigDnsServerList	IP4_ARRAY
DnsConfigSearchList	Não implementado
DnsConfigAdapterInfo	Não implementado
DnsConfigPrimaryHostNameRegistrationEnabled	DWORD
DnsConfigAdapterHostNameRegistrationEnabled	DWORD
DnsConfigAddressRegistrationMaxCount	DWORD
DnsConfigHostName_W	PWCHAR
DnsConfigHostName_A	PCHAR
DnsConfigHostName_UTF8	PCHAR
DnsConfigFullHostName_W	PWCHAR
DnsConfigFullHostName_A	PCHAR
DnsConfigFullHostName_UTF8	PCHAR

[in, out] pBufLen

O comprimento do buffer, em bytes. Se o buffer fornecido não for suficiente, um erro será retornado e pBufferLength contém o tamanho mínimo do buffer necessário. Ignorado na entrada se do Sinalizador estiver definido como verdadeiro.

Valor de retorno

Retorna a confirmação de êxito após a conclusão bem-sucedida. Caso contrário, retorna o código de erro específico do DNS apropriado, conforme definido em Winerror.h.

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_CONFIG_TYPE

DNS_RECORD

DnsQuery

Compartilhar via