DsRemoveDsServerA-Funktion (ntdsapi.h)
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 entweder vom DSBind- oder DSBindWithCredWithCred-Funktion abgerufen wird.
[in] ServerDN
Zeigen Sie auf eine mit Null beendete Zeichenfolge, die den vollqualifizierten distinguishierten Namen des zu entfernenden Domänencontrollers angibt.
[in, optional] DomainDN
Zeiger auf eine mit Null beendete Zeichenfolge, die eine domäne angibt, die von ServerDN-gehostet wird. Wenn dieser Parameter NULL-ist, wird keine Überprüfung ausgefü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 DomainDN-NULL-ist.
[in] fCommit
Enthält einen booleschen Wert, der angibt, ob der Domänencontroller tatsächlich entfernt werden soll. Wenn dieser Parameter nicht null ist, wird ServerDN- entfernt. Wenn dieser Parameter null ist, wird das Vorhandensein ServerDN- aktiviert, und fLastDcInDomain- geschrieben wird, der Domänencontroller wird jedoch nicht entfernt.
Rückgabewert
Gibt ERROR_SUCCESS zurück, wenn der Fehlercode Win32 oder RPC erfolgreich war. Mögliche Fehlercodes sind die folgenden.
Bemerkungen
Anmerkung
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 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 |
|---|---|
| mindestens unterstützte Client- | Windows Vista |
| mindestens unterstützte Server- | Windows Server 2008 |
| Zielplattform- | Fenster |
| Header- | ntdsapi.h |
| Library | Ntdsapi.lib |
| DLL- | Ntdsapi.dll |