DsReplicaDelW, fonction (ntdsapi.h)

Article
11/20/2024

La fonction DsReplicaDel supprime une référence de source de réplication d’un contexte de nommage de destination (NC).

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 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 en tant qu’objet, instancié ou non, ou un fantôme de référence, par exemple un fantôme avec un GUID.

[in] DsaSrc

Pointeur vers une chaîne Unicode terminée par null constante qui spécifie l’adresse spécifique au transport de l’agent de 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ù le GUID partie du nom est le GUID GUID de l’objet nTDSDSA pour le serveur source.

[in] Options

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

DS_REPDEL_ASYNCHRONOUS_OPERATION

Effectue cette opération de façon asynchrone.

DS_REPDEL_IGNORE_ERRORS

Ignore toute erreur générée lors du contact de la source pour lui demander de supprimer ce contrôleur de réseau de sa liste de serveurs sur lesquels il est répliqué.

DS_REPDEL_INTERSITE_MESSAGING

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

DS_REPDEL_LOCAL_ONLY

Ne contacte pas la source pour lui indiquer de supprimer ce CONTRÔLEUR 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é dans 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.

Valeur de retour

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

Note

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