SetDynamicDNSRegistration-Methode der Win32_NetworkAdapterConfiguration-Klasse
Die SetDynamicDNSRegistration-Methode gibt die dynamische DNS-Registrierung von IP-Adressen für diesen IP-gebundenen Adapter an.
In diesem Thema wird MOF-Syntax (Managed Object Format) verwendet. Weitere Informationen zur Verwendung dieser Methode finden Sie unter Aufrufen einer Methode.
Syntax
uint32 SetDynamicDNSRegistration(
[in] boolean FullDNSRegistrationEnabled,
[in, optional] boolean DomainDNSRegistrationEnabled
);
Parameter
-
FullDNSRegistrationEnabled [in]
-
Wenn true, werden die IP-Adressen für diese Verbindung in DNS unter dem vollständigen DNS-Namen des Computers registriert. Der vollständige DNS-Name des Computers wird auf der Registerkarte Netzwerkidentifikation des System-Systemsteuerung angezeigt.
-
DomainDNSRegistrationEnabled [in, optional]
-
Wenn true, werden die IP-Adressen für diese Verbindung unter dem Domänennamen dieser Verbindung registriert, zusätzlich dazu unter dem vollständigen DNS-Namen des Computers registriert. Der Domänenname dieser Verbindung wird entweder mit der Methode SetDNSDomain festgelegt oder von DHCP zugewiesen. Der registrierte Name ist der Hostname des Computers mit dem angefügten Domänennamen. Dieser Parameter hat nur dann Bedeutung, wenn FullDNSRegistrationEnabled aktiviert ist. Der Standardwert ist false.
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, kein Neustart erforderlich.
-
Erfolgreicher Abschluss, Neustart erforderlich
-
1
Erfolgreicher Abschluss, Neustart erforderlich.
-
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 eines zurückgegebenen instance.
-
Ungültiger Eingabeparameter
-
68
Ungültiger Eingabeparameter.
-
Mehr als 5 Gateways angegeben
-
69
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
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 verlängert werden.
-
DHCP-Lease kann nicht freigegeben werden
-
83
DHCP-Lease kann nicht freigegeben werden.
-
IP-Adresse auf adapter nicht aktiviert
-
84
DIE IP-Adresse ist für den Adapter nicht aktiviert.
-
IPX auf adapter nicht aktiviert
-
85
IPX ist für den Adapter nicht aktiviert.
-
Frame-/Netzwerknummergrenzenfehler
-
86
Frame- oder Netzwerknummerngrenzenfehler.
-
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
Zugriff 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
Dienst kann nicht benachrichtigt werden.
-
Benachrichtigung des DNS-Diensts nicht möglich
-
96
Der DNS-Dienst kann nicht benachrichtigt werden.
-
Schnittstelle nicht konfigurierbar
-
97
Schnittstelle nicht konfigurierbar.
-
Nicht alle DHCP-Leases konnten freigegeben/erneuert werden.
-
98
Nicht alle DHCP-Leases konnten freigegeben oder erneuert werden.
-
DHCP für den Adapter nicht aktiviert
-
100
DHCP ist für den Adapter nicht aktiviert.
-
Andere
-
101 4294967295
Beispiele
Das VBScript-Beispiel Dynamische DNS-Registrierung für einen Netzwerkadapter ändern konfiguriert die dynamische DNS-Registrierung für einen Netzwerkadapter.
Im PowerShell-Beispiel Konfigurieren von iSCSI-Netzwerkkarten gemäß Microsoft Best Practices werden die Konfigurationseinstellungen für einen virtuellen Computer automatisiert.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows Vista |
| Unterstützte Mindestversion (Server) |
WindowsServer 2008 |
| Namespace |
Root\CIMV2 |
| MOF |
|
| DLL |
|