DnsValidateServerStatus-Funktion (windns.h)

  • Artikel

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