Função DnsQueryConfig (windns.h)

Artigo
08/27/2023

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 a memória deve ser alocada para as informações de configuração. Defina Sinalizador como DNS_CONFIG_FLAG_ALLOC para alocar memória; caso contrário, defina-o como 0.

Nota Libere 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 Config .

Parâmetro Config	Tipo de dados de 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 conterá o tamanho mínimo do buffer necessário. Ignorado na entrada se Sinalizador estiver definido como TRUE.

Valor retornado

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


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_CONFIG_TYPE

DNS_RECORD

DnsQuery

Compartilhar via