DsRemoveDsServerW, fonction (ntdsapi.h)

Article
11/20/2024

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 DsRemoveDsServerW(
  [in]            HANDLE hDs,
  [in]            LPWSTR ServerDN,
  [in, optional]  LPWSTR 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 est NULL, aucune vérification n’est effectuée pour s’assurer que ServerDN est le dernier contrôleur de domaine dans domaine.

[out, optional] fLastDcInDomain

Pointeur vers une valeur booléenne qui reçoit TRUE si serverDN est le dernier contrôleur de domaine dans domaine ou FALSE sinon. Ce paramètre reçoit FALSE si DomainDN est 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 n’est pas 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 écrite, mais le contrôleur de domaine n’est pas supprimé.

Valeur de retour

Retourne ERROR_SUCCESS en cas de réussite ou de code d’erreur Win32 ou RPC en cas d’échec. Les codes d’erreur possibles sont les suivants.

Remarques

Note

L’en-tête ntdsapi.h définit DsRemoveDsServer comme 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. Le mélange 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.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows Vista
serveur minimum pris en charge	Windows Server 2008
plateforme cible	Windows
d’en-tête	ntdsapi.h
bibliothèque	Ntdsapi.lib
DLL	Ntdsapi.dll

Voir aussi

fonctions de gestion du contrôleur de domaine et de la réplication

DsBind

DsBindWithCred

DsRemoveDsDomain

Partager via