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 die 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]
-
True gibt an, dass die IP-Adressen für diese Verbindung im DNS unter dem vollständigen DNS-Namen des Computers registriert sind. Der vollständige DNS-Name des Computers wird auf der Registerkarte Netzwerkidentifikation des System-Systemsteuerung angezeigt.
-
DomainDNSRegistrationEnabled [ in, optional]
-
True gibt an, dass die IP-Adressen für diese Verbindung zusätzlich zum vollständigen DNS-Namen des Computers unter dem Domänennamen dieser Verbindung registriert werden. Der Domänenname dieser Verbindung wird entweder mithilfe der Methode SetDNSDomain festgelegt oder von DHCP zugewiesen. Der registrierte Name ist der Hostname des Computers, an den der Domänenname angefügt ist. Dieser Parameter hat nur dann eine 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 (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 konnten freigegeben oder erneuert werden.
-
DHCP für Adapter nicht aktiviert
-
100
DHCP für Adapter nicht aktiviert.
-
Andere
-
101 4294967295
Beispiele
Im Beispiel Modify Dynamic DNS Registration for a Network Adapter VBScript (Dynamische DNS-Registrierung für einen Netzwerkadapter ändern) wird die dynamische DNS-Registrierung für einen Netzwerkadapter konfiguriert.
Im Microsoft Best Practices PowerShell-Beispiel Konfigurieren von iSCSI-Netzwerkkarten werden die Konfigurationseinstellungen für einen virtuellen Computer automatisiert.
Requirements (Anforderungen)
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows Vista |
| Unterstützte Mindestversion (Server) |
Windows Server 2008 |
| Namespace |
Stamm \ CIMV2 |
| MOF |
|
| DLL |
|