Função DnsQueryConfig (windns.h)

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.

[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 .

[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

Consulte também

DNS_CONFIG_TYPE

DNS_RECORD

DnsQuery