DnsValidateServerStatus-Funktion (windns.h)

Artikel
08/27/2023

Die DnsValidateServerStatus-Funktion überprüft eine IP-Adresse als geeigneten DNS-Server.

Syntax

DNS_STATUS DnsValidateServerStatus(
  [in]  PSOCKADDR server,
  [in]  PCWSTR    queryName,
  [out] PDWORD    serverStatus
);

Parameter

[in] server

Ein Zeiger auf einen SOCKADDR , der die zu untersuchende IPv4- oder IPv6-Adresse des DNS-Servers enthält.

[in] queryName

Ein Zeiger auf eine Unicode-Zeichenfolge, die den vollqualifizierten Domänennamen (Fully Qualified Domain Name, FQDN) des Besitzers des abgefragten Datensatzsatzes darstellt.

[out] serverStatus

Ein Zeiger auf ein DWORD, das die Abfrageüberprüfung status darstellt.

Wert	Bedeutung
ERROR_SUCCESS	Keine Fehler. Der Aufruf war erfolgreich.
DNS_VALSVR_ERROR_INVALID_ADDR	Server Die IP-Adresse war ungültig.
DNS_VALSVR_ERROR_INVALID_NAME	queryName Der FQDN war ungültig.
DNS_VALSVR_ERROR_UNREACHABLE	Der DNS-Server war nicht erreichbar.
DNS_VALSVR_ERROR_NO_RESPONSE	Timeout wartet auf die DNS-Serverantwort.
DNS_VALSVR_ERROR_NO_AUTH	Der DNS-Server war nicht autoritativ, oder queryName wurde nicht gefunden.
DNS_VALSVR_ERROR_REFUSED	Der DNS-Server hat die Abfrage abgelehnt.
DNS_VALSVR_ERROR_NO_TCP	Die TCP-Abfrage hat nicht ERROR_SUCCESS zurückgegeben, nachdem das Überprüfungssystem bereits eine erfolgreiche Abfrage an den DNS-Server mithilfe von UDP abgeschlossen hatte.
DNS_VALSVR_ERROR_UNKNOWN	Unbekannter Fehler aufgetreten.

Rückgabewert

Die DnsValidateServerStatus-Funktion weist die folgenden möglichen Rückgabewerte auf:

Anforderungen


Unterstützte Mindestversion (Client)	Windows 7 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 R2 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	windns.h
Bibliothek	Dnsapi.lib
DLL	Dnsapi.dll

Weitere Informationen

DNS-Funktionen

Freigeben über