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: _Outptr_result_buffer_(*pcServers) DNS_CUSTOM_SERVER**

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.

Retornar valor

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

Comentários

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
Cliente mínimo com suporte Windows Build 22000
Servidor mínimo com suporte Windows Build 22000
Plataforma de Destino Windows
Cabeçalho windns.h
Biblioteca Dnsapi.lib
DLL Dnsapi.dll

Confira também