DsRemoveDsServerA-Funktion (ntdsapi.h)

  • Artikel

Die DsRemoveDsServer-Funktion entfernt alle Ablaufverfolgungen eines Verzeichnisdienst-Agents (DSA) aus dem globalen Bereich des Verzeichnisdiensts.

Syntax

NTDSAPI DWORD DsRemoveDsServerA(
  [in]            HANDLE hDs,
  [in]            LPSTR  ServerDN,
  [in, optional]  LPSTR  DomainDN,
  [out, optional] BOOL   *fLastDcInDomain,
  [in]            BOOL   fCommit
);

Parameter

[in] hDs

Enthält ein Verzeichnisdiensthandle, das von der FUNKTION DSBind oder DSBindWithCred abgerufen wurde.

[in] ServerDN

Zeiger auf eine NULL-Zeichenfolge, die den vollqualifizierten distinguished Name des zu entfernenden Domänencontrollers angibt.

[in, optional] DomainDN

Zeiger auf eine NULL-Zeichenfolge, die eine von ServerDN gehostete Domäne angibt. Wenn dieser Parameter NULL ist, wird keine Überprüfung durchgeführt, um sicherzustellen, dass ServerDN der letzte Domänencontroller in DomainDN ist.

[out, optional] fLastDcInDomain

Zeiger auf einen booleschen Wert, der TRUE empfängt, wenn ServerDN der letzte DC in DomainDN oder FALSE ist. Dieser Parameter empfängt FALSE , wenn DomainDNNULL ist.

[in] fCommit

Enthält einen booleschen Wert, der angibt, ob der Domänencontroller tatsächlich entfernt werden soll. Wenn dieser Parameter nichtzero ist, wird ServerDN entfernt. Wenn dieser Parameter 0 ist, wird das Vorhandensein von ServerDN überprüft, und fLastDcInDomain wird geschrieben, aber der Domänencontroller wird nicht entfernt.

Rückgabewert

Gibt ERROR_SUCCESS zurück, wenn erfolgreich oder ein Win32- oder RPC-Fehlercode, wenn nicht erfolgreich. Mögliche Fehlercodes sind:

Hinweise

Hinweis

Der ntdsapi.h-Header definiert DsRemoveDsServer 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 nicht codierungsneutralem Code 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 ntdsapi.h
Bibliothek Ntdsapi.lib
DLL Ntdsapi.dll

Weitere Informationen

Domänencontroller und Replikationsverwaltungsfunktionen

DsBind

DsBindWithCred

DsRemoveDsDomain