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 |
|
| DLL |
|