Compartilhar via


Função DnsSetApplicationSettings (windns.h)

Define as configurações de DNS por aplicativo. Isso inclui a capacidade de definir servidores DNS por aplicativo como fallback para os servidores configurados pelo sistema ou exclusivamente.

Sintaxe

DWORD DnsSetApplicationSettings(
  DWORD                          cServers,
  const DNS_CUSTOM_SERVER        *pServers,
  const DNS_APPLICATION_SETTINGS *pSettings
);

Parâmetros

cServers

Tipo: _In_ DWORD

O número de servidores DNS personalizados presentes no parâmetro pServers.

pServers

Tipo: DNS_CUSTOM_SERVER* _In_reads_(cServers)

Uma matriz de DNS_CUSTOM_SERVER que contém elementos cServers. Se cServers for 0, isso deverá ser NULL.

pSettings

Tipo: _In_opt_ DNS_APPLICATION_SETTINGS*

Um ponteiro para um objeto DNS_APPLICATION_SETTINGS que descreve configurações adicionais para servidores DNS personalizados.

Se isso for NULL, os servidores DNS personalizados passados para a API serão usados como fallback para os configurados pelo sistema.

Se isso apontar para um objeto DNS_APPLICATION_SETTINGS que tenha o sinalizador de DNS_APP_SETTINGS_EXCLUSIVE_SERVERS definido em seu membro sinalizadores , isso significa usar exclusivamente os servidores DNS personalizados.

Valor de retorno

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

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