SetDNSDomain-Methode der Win32 _ NetworkAdapterConfiguration-Klasse

Die WMI-Klassenmethode SetDNSDomain ermöglicht das Festlegen der DNS-Domäne.

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 SetDNSDomain(
  [in] string DNSDomain
);

Parameter

DNSDomain [ In]

Domäne, der das DNS zugeordnet ist, dargestellt durch einen Organisationsnamen gefolgt von einem Punkt und einer Erweiterung, die den Typ der Organisation angibt.

Beispiel: "microsoft.com"

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-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 verlängert 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 auf dem 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

Bemerkungen

Dies ist ein instanzabhängiger Methodenaufruf, der pro Adapter angewendet wird. Die Einstellung gilt für den Zieladapter.

Beispiele

Im VbScript-Codebeispiel Zuweisen der DNS-Domäne für einen Netzwerkadapter im TechNet-Katalog wird SetDNSDomain verwendet, um die DNS-Domäne für einen TCP/IP-gebundenen Netzwerkadapter festzulegen.

Das Beispiel Ändern der TCP/IP-Konfiguration für einen Computer-VBScript-Code im TechNet-Katalog verwendet SetDNSDomain, um TCP/IP-Einstellungen für einen Netzwerkadapter zu ändern.

Das Beispiel DHCP Einstellungen auf einem Computer mit VBScript aktivieren im TechNet-Katalog verwendet SetDNSDomain, um alle Einstellungen zu konfigurieren, die normalerweise zum Aktivieren von DHCP auf einem Computer erforderlich sind.

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

Computersystemhardwareklassen

Win32 _ NetworkAdapterConfiguration

WMI-Aufgaben: Netzwerk

WMI-Aufgaben: Konten und Domänen

IPv6- und IPv4-Unterstützung in WMI