Compartilhar via


Função DnsGetApplicationSettings (windns.h)

Recupera as configurações de DNS por aplicativo.

Sintaxe

DWORD DnsGetApplicationSettings(
  DWORD                    *pcServers,
  DNS_CUSTOM_SERVER        **ppDefaultServers,
  DNS_APPLICATION_SETTINGS *pSettings
);

Parâmetros

pcServers

Tipo: _Out_ * DWORD

Após a chamada de função, isso apontará para o número de servidores DNS personalizados que o aplicativo configurou. Se não houver servidores personalizados configurados ou se a função falhar, isso será definido como 0.

ppDefaultServers

Tipo: DNS_CUSTOM_SERVER** _Outptr_result_buffer_(*pcServers)

Após a chamada de função, isso apontará para a matriz de servidores personalizados DNS configurados para o aplicativo. Se o aplicativo não tiver servidores configurados ou se a função falhar, isso será definido como NULL.

pSettings

Tipo: _Out_opt_ DNS_APPLICATION_SETTINGS*

Um ponteiro para um objeto DNS_APPLICATION_SETTINGS, preenchido com as configurações do aplicativo.

Valor de retorno

Um DWORD que contém ERROR_SUCCESS com êxito ou um código de erro sobre falha.

Observações

Para evitar vazamentos de memória, você deve chamar DnsFreeCustomServers nos servidores retornados por DnsGetApplicationSettings por meio de seu parâmetro pSettings .

Requisitos

Requisito Valor
de cliente com suporte mínimo Windows Build 22000
servidor com suporte mínimo Windows Build 22000
da Plataforma de Destino Windows
cabeçalho windns.h
biblioteca Dnsapi.lib
de DLL Dnsapi.dll

Consulte também

  • DnsFreeCustomServers