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: _In_reads_(cServers) DNS_CUSTOM_SERVER*

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 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 DNS_APP_SETTINGS_EXCLUSIVE_SERVERS definido em seu membro Flags , isso significa usar exclusivamente os servidores DNS personalizados.

Retornar valor

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

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