DsRemoveDsServerA, fonction (ntdsapi.h)
La fonction DsRemoveDsServer supprime toutes les traces d’un agent de service d’annuaire (DSA) de la zone globale du service d’annuaire.
Syntaxe
NTDSAPI DWORD DsRemoveDsServerA(
[in] HANDLE hDs,
[in] LPSTR ServerDN,
[in, optional] LPSTR DomainDN,
[out, optional] BOOL *fLastDcInDomain,
[in] BOOL fCommit
);
Paramètres
[in] hDs
Contient un handle de service d’annuaire obtenu à partir de la fonction DSBind ou DSBindWithCred .
[in] ServerDN
Pointeur vers une chaîne terminée par null qui spécifie le nom unique complet du contrôleur de domaine à supprimer.
[in, optional] DomainDN
Pointeur vers une chaîne terminée par null qui spécifie un domaine hébergé par ServerDN. Si ce paramètre a la valeur NULL, aucune vérification n’est effectuée pour s’assurer que ServerDN est le dernier contrôleur de domaine dans DomainDN.
[out, optional] fLastDcInDomain
Pointeur vers une valeur booléenne qui reçoit TRUE si ServerDN est le dernier contrôleur de domaine dans DomainDN ou FALSE dans le cas contraire. Ce paramètre reçoit FALSE si DomainDN a la valeur NULL.
[in] fCommit
Contient une valeur booléenne qui spécifie si le contrôleur de domaine doit réellement être supprimé. Si ce paramètre est différent de zéro, ServerDN est supprimé. Si ce paramètre est égal à zéro, l’existence de ServerDN est vérifiée et fLastDcInDomain est écrit, mais le contrôleur de domaine n’est pas supprimé.
Valeur retournée
Retourne ERROR_SUCCESS en cas de réussite ou un code d’erreur Win32 ou RPC en cas d’échec. Les codes d’erreur possibles sont les suivants.
Remarques
Notes
L’en-tête ntdsapi.h définit DsRemoveDsServer en tant qu’alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. La combinaison de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.
Configuration requise
Condition requise | Valeur |
---|---|
Client minimal pris en charge | Windows Vista |
Serveur minimal pris en charge | Windows Server 2008 |
Plateforme cible | Windows |
En-tête | ntdsapi.h |
Bibliothèque | Ntdsapi.lib |
DLL | Ntdsapi.dll |
Voir aussi
Fonctions de gestion des contrôleurs de domaine et de la réplication
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour