DsDeregisterDnsHostRecordsA-Funktion (dsgetdc.h)
Die DsDeregisterDnsHostRecords-Funktion löscht DNS-Einträge, mit Ausnahme von Typ A-Einträgen, die von einem Domänencontroller registriert werden. Nur ein Administrator, Kontooperator oder Serveroperator kann diese Funktion aufrufen.
Syntax
DSGETDCAPI DWORD DsDeregisterDnsHostRecordsA(
[in, optional] LPSTR ServerName,
[in, optional] LPSTR DnsDomainName,
[in, optional] GUID *DomainGuid,
[in, optional] GUID *DsaGuid,
[in] LPSTR DnsHostName
);
Parameter
[in, optional] ServerName
Die Zeichenfolge mit NULL-Beendigung, die den Namen des Remotedomänencontrollers angibt. Kann auf NULL festgelegt werden, wenn die aufrufende Anwendung auf dem Domänencontroller ausgeführt wird, der aktualisiert wird.
[in, optional] DnsDomainName
Die null-endende Zeichenfolge, die den DNS-Domänennamen der Domäne angibt, die vom Domänencontroller belegt wird. Es ist unnötig, dass dies eine Domäne ist, die von diesem Domänencontroller gehostet wird. Bei NULL wird der DnsHostName mit entfernter bezeichnung links angegeben.
[in, optional] DomainGuid
Zeiger auf die Domänen-GUID der Domäne. Wenn NULL, werden GUID-spezifische Namen nicht entfernt.
[in, optional] DsaGuid
Zeiger auf die GUID des zu löschenden NTDS-DSA-Objekts . Wenn NULL, werden NTDS-DSA-spezifische Namen nicht entfernt.
[in] DnsHostName
Zeiger auf die NULL-endende Zeichenfolge, die den DNS-Hostnamen des Domänencontrollers angibt, dessen DNS-Einträge gelöscht werden.
Rückgabewert
Diese Funktion gibt DSGETDCAPI DWORD zurück.
Hinweise
Mit dieser Funktion werden nur SRV- und CNAME-Einträge registriert. Die Datensätze vom Typ A bleiben erhalten. Löschen von websitespezifischen Datensätzen, z. B. _ldap. Tcp.<SiteName>._sites.dc._msdcs.<DnsDomainName> wird für jeden Standort (<in diesem Beispiel SiteName> ) im Unternehmen des Domänencontrollers versucht, auf dem die Funktion ausgeführt wird. Daher kann dieser Funktionsaufruf zu einer zeitaufwändigen Ausführung führen und für Unternehmen mit vielen Standorten erheblichen Netzwerkdatenverkehr generieren.
Hinweis
Der dsgetdc.h-Header definiert DsDeregisterDnsHostRecords als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht Codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows Vista |
| Unterstützte Mindestversion (Server) | Windows Server 2008 |
| Zielplattform | Windows |
| Kopfzeile | dsgetdc.h |
| Bibliothek | Netapi32.lib |
| DLL | Netapi32.dll |