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 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 |