DsReplicaDelW, fonction (ntdsapi.h)

Article
03/04/2024

La fonction DsReplicaDel supprime une référence de source de réplication d’un contexte d’affectation de noms de destination.

Syntaxe

NTDSAPI DWORD DsReplicaDelW(
  [in] HANDLE  hDS,
  [in] LPCWSTR NameContext,
  [in] LPCWSTR DsaSrc,
  [in] ULONG   Options
);

Paramètres

[in] hDS

Contient un handle de service d’annuaire obtenu à partir de la fonction DSBind ou DSBindWithCred .

[in] NameContext

Pointeur vers une chaîne constante terminée par un caractère Null qui spécifie le nom unique (DN) du nc de destination à partir duquel supprimer le réplica. L’enregistrement NC de destination doit exister localement sous la forme d’un objet, instancié ou non, ou d’un fantôme de référence, par exemple un fantôme avec un GUID.

[in] DsaSrc

Pointeur vers une chaîne Unicode constante terminée par un caractère Null qui spécifie l’adresse spécifique au transport de l’agent système d’annuaire source (DSA). Ce serveur source est identifié par un nom de chaîne, et non par son UUID. Un nom de chaîne approprié pour DsaSrc est généralement un nom DNS basé sur un GUID, où la partie GUID du nom est le GUID de l’objet nTDSDSA pour le serveur source.

[in] Options

Transmet les données supplémentaires utilisées pour traiter la demande. Ce paramètre peut être une combinaison des valeurs suivantes.

DS_REPDEL_ASYNCHRONOUS_OPERATION

Effectue cette opération de manière asynchrone.

DS_REPDEL_IGNORE_ERRORS

Ignore toute erreur générée par le contact de la source pour lui demander de supprimer ce contrôleur de réseau de sa liste de serveurs sur lesquels il se réplique.

DS_REPDEL_INTERSITE_MESSAGING

Signifie que la réplica est basée sur la messagerie plutôt que synchronisée à l’aide du service d’annuaire natif RPC.

DS_REPDEL_LOCAL_ONLY

Ne contacte pas la source pour lui demander de supprimer ce nc de sa liste de serveurs sur lesquels il est répliqué. Si cet indicateur n’est pas défini et que le lien est basé sur RPC, la source est contactée.

DS_REPDEL_NO_SOURCE

Supprime tous les objets du contrôleur de réseau. Cette option est valide uniquement pour les NCs en lecture seule sans source.

DS_REPDEL_REF_OK

Autorise la suppression d’un réplica en lecture seule même s’il source d’autres réplicas en lecture seule.

DS_REPDEL_WRITEABLE

Signifie que le réplica supprimé peut être écrit dans.

Valeur retournée

Si la fonction réussit, la valeur de retour est ERROR_SUCCESS.

Si la fonction échoue, la valeur de retour est une erreur d’API Win32 standard ou ERROR_INVALID_PARAMETER si un paramètre n’est pas valide.

Remarques

Notes

L’en-tête ntdsapi.h définit DsReplicaDel 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