SetDNSServerSearchOrder-Methode der Win32_NetworkAdapterConfiguration-Klasse
Die WMI-KlassenmethodeSetDNSServerSearchOrder verwendet ein Array von Zeichenfolgenelementen, um die Suchreihenfolge des Servers festzulegen.
In diesem Thema wird MOF-Syntax (Managed Object Format) 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 nach DNS-Servern abfragt werden sollen.
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 (1) für einen erfolgreichen Abschluss, wenn ein Neustart erforderlich ist, und eine andere Zahl, wenn ein Fehler vorliegt. Weitere Informationen zu Fehlercodes finden Sie unter WMI-Fehlerkonstanten 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 zurückgegebenen Instanz (67)
-
Ungültiger Eingabeparameter (68)
-
Mehr als 5 Gateways angegeben (69)
-
Ungültige IP-Adresse (70)
-
Ungültige Gateway-IP-Adresse (71)
-
Fehler beim Zugriff 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 verlängert werden (82)
-
DHCP-Lease kann nicht freigegeben werden (83)
-
IP auf Adapter nicht aktiviert (84)
-
IPX auf Adapter nicht aktiviert (85)
-
Frame/Network Number bounds error (86)
-
Ungültiger Frametyp (87)
-
Ungültige Netzwerknummer (88)
-
Doppelte Netzwerknummer (89)
-
Parameter außerhalb der Grenzen (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)
-
Sonstige (101 4294967295)
Bemerkungen
Dies ist ein instance-abhängiger Methodenaufruf, der auf Adapterbasis angewendet wird. Nachdem statische DNS-Server für die Verwendung des Dynamic Host Configuration Protocol (DHCP) anstelle von statischen DNS-Servern angegeben wurden, können Sie die -Methode aufrufen, ohne "in"-Parameter anzugeben.
Beispiele
Das Beispiel Set DNS Server Search Order for Multiple Computers in an Organizational Unit VBScript im TechNet Gallery ruft die DNS Server-Suchreihenfolge für mehrere Computer ab, die zu einer Organisationseinheit gehören, oder legt diese fest.
Im VBScript-Beispiel Ändern der DNS-Server-Suchreihenfolge für einen Netzwerkadapter wird ein TCP/IP-gebundener Netzwerkadapter so konfiguriert, dass zwei DNS-Server verwendet werden.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows Vista |
| Unterstützte Mindestversion (Server) |
WindowsServer 2008 |
| Namespace |
Root\CIMV2 |
| MOF |
|
| DLL |
|