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

DsBind

DsBindWithCred

DsRemoveDsDomain