EnableDNS-Methode der Win32 _ NetworkAdapterConfiguration-Klasse
Die statische Methode der EnableDNS WMI-Klasse aktiviert die Domain Name System (DNS) für den Dienst.
In diesem Thema wird die MOF-Syntax (Managed Object Format) verwendet. Weitere Informationen zur Verwendung dieser Methode finden Sie unter Aufrufen einer Methode.
Syntax
uint32 EnableDNS(
[in, optional] string DNSHostName,
[in, optional] string DNSDomain,
[in, optional] string DNSServerSearchOrder[],
[in, optional] string DNSDomainSuffixSearchOrder[]
);
Parameter
-
DNSHostName [ in, optional]
-
Name des DNS-Hosts, der von dieser Methode aktiviert wird.
Beispiel: "corpdns"
-
DNSDomain [ in, optional]
-
Stellt einen Organisationsnamen dar, gefolgt von einem Punkt und einer Erweiterung, die den Organisationstyp angibt.
Beispiel: "microsoft.com"
-
DNSServerSearchOrder [ in, optional]
-
Liste der Server-IP-Adressen, die nach DNS-Servern abgefragt werden sollen.
-
DNSDomainSuffixSearchOrder [ in, optional]
-
DNS-Domänensuffix, das während der Namensauflösung an einen Hostnamen angefügt wird. Beim Auflösen eines vollqualifizierten Domänennamens (Fully Qualified Domain Name, FQDN) aus einem reinen Hostnamen fügt das System den lokalen Domänennamen an. Wenn die Namensauflösung nicht erfolgreich ist, verwendet das System die Domänensuffixliste, um zusätzliche FQDNs in der aufgeführten Reihenfolge zu erstellen, und fragt dann die DNS-Server nach diesen ab.
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 beliebige andere Zahl, wenn ein Fehler auftritt. 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, kein Neustart erforderlich.
-
Erfolgreicher Abschluss, Neustart erforderlich
-
1
Erfolgreicher Abschluss, Neustart erforderlich.
-
Die Methode wird auf dieser Plattform nicht unterstützt.
-
64
Die Methode wird auf dieser Plattform nicht unterstützt.
-
Unbekannter Fehler
-
65
Unbekannter Fehler.
-
Ungültige Subnetzmaske
-
66
Ungültige Subnetzmaske.
-
Fehler beim Verarbeiten einer zurückgegebenen Instanz
-
67
Fehler beim Verarbeiten einer zurückgegebenen Instanz.
-
Ungültiger Eingabeparameter
-
68
Ungültiger Eingabeparameter.
-
Mehr als 5 Gateways angegeben
-
69
Es wurden mehr als fünf Gateways angegeben.
-
Ungültige IP-Adresse
-
70
Ungültige IP-Adresse.
-
Ungültige Gateway-IP-Adresse
-
71
Ungültige Gateway-IP-Adresse.
-
Fehler beim Zugriff auf die Registrierung für die angeforderten Informationen
-
72
Fehler beim Zugriff auf die Registrierung für die angeforderten Informationen.
-
Ungültiger Domänenname
-
73
Ungültiger Domänenname.
-
Ungültiger Hostname
-
74
Ungültiger Hostname.
-
Kein primärer/sekundärer WINS-Server definiert
-
75
Es wurde kein primärer oder sekundärer WINS-Server definiert.
-
Ungültige Datei
-
76
Ungültige Datei.
-
Ungültiger Systempfad
-
77
Ungültiger Systempfad.
-
Fehler beim Kopieren der Datei
-
78
Fehler beim Kopieren der Datei.
-
Ungültiger Sicherheitsparameter
-
79
Ungültiger Sicherheitsparameter.
-
TCP/IP-Dienst kann nicht konfiguriert werden
-
80
Tcp/IP-Dienst kann nicht konfiguriert werden.
-
DHCP-Dienst kann nicht konfiguriert werden
-
81
Dhcp-Dienst kann nicht konfiguriert werden.
-
DHCP-Lease kann nicht erneuert werden
-
82
DHCP-Lease kann nicht erneuert werden.
-
DHCP-Lease kann nicht veröffentlicht werden
-
83
DHCP-Lease kann nicht veröffentlicht werden.
-
IP auf Adapter nicht aktiviert
-
84
DIE IP-Adresse ist für den Adapter nicht aktiviert.
-
IPX auf Adapter nicht aktiviert
-
85
IPX für Adapter nicht aktiviert.
-
Frame-/Netzwerknummern-Begrenzungsfehler
-
86
Frame- oder Netzwerknummern-Begrenzungsfehler.
-
Ungültiger Frametyp
-
87
Ungültiger Frametyp.
-
Ungültige Netzwerknummer
-
88
Ungültige Netzwerknummer.
-
Doppelte Netzwerknummer
-
89
Doppelte Netzwerknummer.
-
Parameter außerhalb der Grenzen
-
90
Parameter außerhalb der Grenzen.
-
Zugriff verweigert
-
91
Der Zugriff wurde verweigert.
-
Nicht genügend Arbeitsspeicher
-
92
Nicht genügend Arbeitsspeicher.
-
Bereits vorhanden
-
93
Ist bereits vorhanden.
-
Pfad, Datei oder Objekt nicht gefunden
-
94
Pfad, Datei oder Objekt nicht gefunden.
-
Dienst kann nicht benachrichtigt werden
-
95
Der Dienst kann nicht benachrichtigt werden.
-
DNS-Dienst kann nicht benachrichtigt werden
-
96
Der DNS-Dienst kann nicht benachrichtigt werden.
-
Schnittstelle nicht konfigurierbar
-
97
Die Schnittstelle kann nicht konfiguriert werden.
-
Nicht alle DHCP-Leases konnten freigegeben/erneuert werden.
-
98
Nicht alle DHCP-Leases können freigegeben oder erneuert werden.
-
DHCP für Adapter nicht aktiviert
-
100
DHCP für Adapter nicht aktiviert.
-
Andere
-
101 4294967295
Beispiele
Das folgende Codebeispiel aus dem VBScript-Codebeispiel Enable DNS on All Network Adapters im TechNet Gallery aktiviert DNS für alle Netzwerkadapter auf einem Computer.
On Error Resume Next
strComputer = "."
Set objWMIService = GetObject("winmgmts:" _
& "{impersonationLevel=impersonate}!\\" & strComputer & "\root\cimv2")
Set objNetworkSettings = objWMIService.Get("Win32_NetworkAdapterConfiguration")
strHostName = "fabrikam1"
arrDNSSuffixes = Array("hr.fabrikam.com", "research.fabrikam.com")
objNetworkSettings.EnableDNS strHostName, , , arrDNSSuffixes
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows Vista |
| Unterstützte Mindestversion (Server) |
Windows Server 2008 |
| Namespace |
Stamm \ CIMV2 |
| MOF |
|
| DLL |
|