Freigeben über

DnsSetApplicationSettings-Funktion (windns.h)

  • Artikel

Konfiguriert die DNS-Einstellungen pro Anwendung. Dies schließt die Möglichkeit ein, DNS-Server pro Anwendung entweder als Fallback auf die vom System konfigurierten Server oder ausschließlich festzulegen.

Syntax

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

Parameter

cServers

Typ: _In_ DWORD

Die Anzahl der benutzerdefinierten DNS-Server, die im pServers-Parameter vorhanden sind.

pServers

Typ: _In_reads_(cServers) DNS_CUSTOM_SERVER*

Ein Array von DNS_CUSTOM_SERVER , das cServers-Elemente enthält. Wenn cServers den Wert 0 aufweist, muss dies NULL sein.

pSettings

Typ: _In_opt_ DNS_APPLICATION_SETTINGS*

Ein Zeiger auf ein DNS_APPLICATION_SETTINGS-Objekt , das zusätzliche Einstellungen für benutzerdefinierte DNS-Server beschreibt.

Wenn dies NULL ist, werden die benutzerdefinierten DNS-Server, die an die API übergeben werden, als Fallback auf die systemkonfigurierten server verwendet.

Wenn dies auf ein DNS_APPLICATION_SETTINGS -Objekt verweist, dessen Flag DNS_APP_SETTINGS_EXCLUSIVE_SERVERS im Flags-Member festgelegt ist, bedeutet dies, dass die benutzerdefinierten DNS-Server ausschließlich verwendet werden.

Rückgabewert

Ein DWORD , das ERROR_SUCCESS bei Erfolg oder einen Fehlercode bei Einem Fehler enthält.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Build 22000
Unterstützte Mindestversion (Server) Windows Build 22000
Zielplattform Windows
Kopfzeile windns.h
Bibliothek Dnsapi.lib
DLL Dnsapi.dll