Partager via


Fonction DnsSetApplicationSettings (windns.h)

Configure les paramètres DNS par application. Cela inclut la possibilité de définir des serveurs DNS par application comme secours pour les serveurs configurés par le système ou exclusivement.

Syntaxe

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

Paramètres

cServers

Type : _in_ DWORD

Nombre de serveurs DNS personnalisés présents dans le paramètre pServers .

pServers

Type : _In_reads_(cServers) DNS_CUSTOM_SERVER*

Tableau de DNS_CUSTOM_SERVER qui contient des éléments cServers . Si cServers a la valeur 0, cette valeur doit être NULL.

pSettings

Type : DNS_APPLICATION_SETTINGS _In_opt_*

Pointeur vers un objet DNS_APPLICATION_SETTINGS décrivant des paramètres supplémentaires pour les serveurs DNS personnalisés.

Si cette valeur est NULL, les serveurs DNS personnalisés passés à l’API seront utilisés comme secours pour les serveurs configurés par le système.

Si cela pointe vers un objet DNS_APPLICATION_SETTINGS dont l’indicateur DNS_APP_SETTINGS_EXCLUSIVE_SERVERS est défini dans son membre Flags , cela signifie qu’il utilise exclusivement les serveurs DNS personnalisés.

Valeur retournée

DWORD contenant des ERROR_SUCCESS sur la réussite ou un code d’erreur en cas d’échec.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows Build 22000
Serveur minimal pris en charge Windows Build 22000
Plateforme cible Windows
En-tête windns.h
Bibliothèque Dnsapi.lib
DLL Dnsapi.dll