SetDNSServerSearchOrder-Methode der Win32 _ NetworkAdapterConfiguration-Klasse

Die WMI-Klassenmethode SetDNSServerSearchOrder verwendet ein Array von Zeichenfolgenelementen, um die Serversuch reihenfolge zu setzen.

In diesem Thema wird Managed Object Format (MOF)-Syntax verwendet. Weitere Informationen zur Verwendung dieser Methode finden Sie unter Aufrufen einer Methode.

Syntax

uint32 SetDNSServerSearchOrder(
  [in] string DNSServerSearchOrder[]
);

Parameter

DNSServerSearchOrder [ In]

Liste der Server-IP-Adressen, die für DNS-Server abfragen werden.

Beispiel: 130.215.24.1 oder 157.54.164.1

Rückgabewert

Gibt den Wert 0 (null) für einen erfolgreichen Abschluss zurück, wenn kein Neustart erforderlich ist, 1 (eins) für einen erfolgreichen Abschluss, wenn ein Neustart erforderlich ist, und eine andere Zahl, wenn ein Fehler auftritt. Weitere Informationen zu Fehlercodes finden Sie unter WMI-Fehlerkonstistenzen oder WbemErrorEnum. Allgemeine HRESULT-Werte finden Sie unter Systemfehlercodes.

Erfolgreicher Abschluss, kein Neustart erforderlich (0)

Erfolgreicher Abschluss, Neustart erforderlich (1)

Methode wird auf dieser Plattform nicht unterstützt (64)

Unbekannter Fehler (65)

Ungültige Subnetzmaske (66)

Fehler beim Verarbeiten einer instanz, die zurückgegeben wurde (67)

Ungültiger Eingabeparameter (68)

Mehr als 5 Gateways angegeben (69)

Ungültige IP-Adresse (70)

Ungültige Gateway-IP-Adresse (71)

Fehler beim Zugreifen auf die Registrierung für die angeforderten Informationen (72)

Ungültiger Domänenname (73)

Ungültiger Hostname (74)

Kein primärer/sekundärer WINS-Server definiert (75)

Ungültige Datei (76)

Ungültiger Systempfad (77)

Fehler beim Kopieren der Datei (78)

Ungültiger Sicherheitsparameter (79)

TCP/IP-Dienst kann nicht konfiguriert werden (80)

DHCP-Dienst kann nicht konfiguriert werden (81)

DHCP-Lease kann nicht erneuert werden (82)

DHCP-Lease kann nicht veröffentlicht werden (83)

IP-Adresse für Adapter nicht aktiviert (84)

IPX auf Adapter nicht aktiviert (85)

Frame-/Netzwerknummer-Begrenzungsfehler (86)

Ungültiger Frametyp (87)

Ungültige Netzwerknummer (88)

Doppelte Netzwerknummer (89)

Parameter out-of-bounds (90)

Zugriff verweigert (91)

Nicht genügend Arbeitsspeicher (92)

Bereits vorhanden (93)

Pfad, Datei oder Objekt nicht gefunden (94)

Dienst kann nicht benachrichtigt werden (95)

Dns-Dienst kann nicht benachrichtigt werden (96)

Schnittstelle nicht konfigurierbar (97)

Nicht alle DHCP-Leases konnten freigegeben/erneuert werden (98)

DHCP auf Adapter nicht aktiviert (100)

Andere (101 4294967295)

Bemerkungen

Dies ist ein instanzabhängiger Methodenaufruf, der pro Adapter angewendet wird. Nachdem statische DNS-Server angegeben wurden, um mit der Verwendung des Dynamic Host Configuration-Protokolls (DHCP) anstelle von statischen DNS-Servern zu beginnen, können Sie die -Methode aufrufen, ohne "in"-Parameter anzugeben.

Beispiele

Im Beispiel Set DNS Server Search Order for Multiple Computers in an Organizational Unit VBScript (DNS-Serversuch reihenfolge für mehrere Computer in einer Organisationseinheit vbscript festlegen) im TechNet-Katalog wird die DNS-Serversuch reihenfolge für mehrere Computer abgerufen oder festgelegt, die zu einer Organisationseinheit gehören.

Im Beispiel Modify the DNS Server Search Order for a Network Adapter VBScript (Ändern der DNS-Serversuch reihenfolge für einen VbScript-Netzwerkadapter) wird ein TCP/IP-gebundener Netzwerkadapter für die Verwendung von zwei DNS-Servern konfiguriert.

Requirements (Anforderungen)

Anforderung Wert
Unterstützte Mindestversion (Client)
Windows Vista
Unterstützte Mindestversion (Server)
Windows Server 2008
Namespace
\Stamm-CIMV2
MOF
CIMWin32.mof
DLL
CIMWin32.dll

Weitere Informationen

Hardwareklassen des Computersystems

Win32 _ NetworkAdapterConfiguration

WMI-Aufgaben: Netzwerk

WMI-Aufgaben: Konten und Domänen

IPv6- und IPv4-Unterstützung in WMI