DsDeregisterDnsHostRecordsW-Funktion (dsgetdc.h)

Die DsDeregisterDnsHostRecords Funktion löscht DNS-Einträge, mit Ausnahme von Typ A-Einträgen, die von einem Domänencontroller registriert wurden. Nur ein Administrator, Kontobetreiber oder Serveroperator kann diese Funktion aufrufen.

Syntax

DSGETDCAPI DWORD DsDeregisterDnsHostRecordsW(
  [in, optional] LPWSTR ServerName,
  [in, optional] LPWSTR DnsDomainName,
  [in, optional] GUID   *DomainGuid,
  [in, optional] GUID   *DsaGuid,
  [in]           LPWSTR DnsHostName
);

Parameter

[in, optional] ServerName

Die mit Null beendete Zeichenfolge, 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 mit Null beendete Zeichenfolge, die den DNS-Domänennamen der Domäne angibt, die vom Domänencontroller belegt wird. Dies ist nicht erforderlich, um eine Domäne zu sein, die von diesem Domänencontroller gehostet wird. Wenn NULL-, wird die DnsHostName- mit der links entfernten Bezeichnung angegeben.

[in, optional] DomainGuid

Zeigen Sie auf die Domänen-GUID der Domäne. Wenn NULL-werden bestimmte GUID-Namen nicht entfernt.

[in, optional] DsaGuid

Zeigen Sie auf die GUID des zu löschenden NTDS-DSA--Objekts. Wenn NULL-, werden NTDS-DSA- bestimmten Namen nicht entfernt.

[in] DnsHostName

Zeigen Sie auf die mit Null beendete 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.

Bemerkungen

Mit dieser Funktion werden nur SRV- und CNAME-Einträge registriert. Der Typ "A"-Datensätze bleibt erhalten. Löschen von websitespezifischen Datensätzen, z. B. _ldap.tcp.<SiteName>._sites.dc._msdcs.<DnsDomainName>wird für jede Website (<SiteName> in diesem Beispiel) im Unternehmen des Domänencontrollers versucht, auf dem die Funktion ausgeführt wird. Daher könnte dieser Funktionsaufruf eine zeitaufwendige Ausführung erstellen und möglicherweise einen erheblichen Netzwerkdatenverkehr für Unternehmen mit vielen Standorten generieren.

Anforderungen

Siehe auch

DsGetDcSiteCoverage

DsGetSiteName-