Partager via


DnsSetApplicationSettings, fonction (windns.h)

Configure les paramètres DNS par application. Cela inclut la possibilité de définir des serveurs DNS par application en tant que secours sur 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 est 0, cela doit être NULL.

pSettings

Type : _In_opt_ DNS_APPLICATION_SETTINGS*

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

S’il s’agit NULL, les serveurs DNS personnalisés passés à l’API seront utilisés comme secours aux serveurs configurés par le système.

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

Valeur de retour

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

Exigences

Exigence Valeur
client minimum pris en charge Windows Build 22000
serveur minimum pris en charge Windows Build 22000
plateforme cible Windows
d’en-tête windns.h
bibliothèque Dnsapi.lib
DLL Dnsapi.dll