Fonction DsReplicaAddW (ntdsapi.h)

Article
08/25/2023

La fonction DsReplicaAdd ajoute une référence de source de réplication à un contexte de nommage de destination.

Syntaxe

NTDSAPI DWORD DsReplicaAddW(
  [in] HANDLE          hDS,
  [in] LPCWSTR         NameContext,
  [in] LPCWSTR         SourceDsaDn,
  [in] LPCWSTR         TransportDn,
  [in] LPCWSTR         SourceDsaAddress,
  [in] const PSCHEDULE pSchedule,
  [in] DWORD           Options
);

Paramètres

[in] hDS

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

[in] NameContext

Chaîne terminée par null qui spécifie le nom unique (DN) du contexte de nommage de destination (NC) pour lequel ajouter 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] SourceDsaDn

Chaîne terminée par null qui spécifie le DN de l’objet NTDS-DSA pour l’agent système du répertoire source. Ce paramètre est obligatoire si Options inclut DS_REPADD_ASYNCHRONOUS_REPLICA ; sinon, elle est ignorée.

[in] TransportDn

Chaîne terminée par null qui spécifie le DN de l’objet interSiteTransport qui représente le transport utilisé pour la communication avec le serveur source. Ce paramètre est obligatoire si Options inclut DS_REPADD_INTERSITE_MESSAGING ; sinon, elle est ignorée.

[in] SourceDsaAddress

Chaîne terminée par null qui spécifie l’adresse spécifique au transport de l’ADS source. Ce serveur source est identifié par un nom de chaîne, et non par son UUID. Un nom de chaîne approprié pour SourceDsaAddress est généralement un nom DNS basé sur un GUID, où la partie GUID du nom est le GUID de l’objet NTDS-DSA pour le serveur source.

[in] pSchedule

Pointeur vers une structure SCHEDULE qui contient les données de planification de réplication pour la source de réplication. Ce paramètre est facultatif et peut être NULL s’il n’est pas utilisé.

[in] Options

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

DS_REPADD_ASYNCHRONOUS_OPERATION

Effectue cette opération de manière asynchrone.

DS_REPADD_ASYNCHRONOUS_REPLICA

Ne réplique pas le nc. Au lieu de cela, enregistrez suffisamment de données d’état pour qu’elles puissent être répliquées ultérieurement.

DS_REPADD_DISABLE_NOTIFICATION

Désactive la synchronisation basée sur la notification pour le nc à partir de cette source. Il s’agit d’un état temporaire. Utilisez DS_REPADD_NEVER_NOTIFY pour désactiver définitivement la synchronisation.

DS_REPADD_DISABLE_PERIODIC

Désactive la synchronisation périodique pour le nc à partir de cette source.

DS_REPADD_INITIAL

Synchronise le nc à partir de cette source lorsque la DSA est démarrée.

DS_REPADD_INTERSITE_MESSAGING

Synchronise à partir de la DSA source à l’aide du transport IMS (Intersite Messaging Service), par exemple, par SMTP, plutôt que du RPC du service d’annuaire natif.

DS_REPADD_NEVER_NOTIFY

Désactive les notifications de modification de cette source. Lorsque cet indicateur est défini, la source n’avertit pas la destination lorsque des modifications se produisent. Cela est recommandé pour toutes les réplications intersite qui peuvent se produire sur des liaisons WAN.

Il s’agit d’un état permanent ; utilisez DS_REPADD_DISABLE_NOTIFICATION pour désactiver temporairement les notifications.

DS_REPADD_PERIODIC

Synchronise régulièrement le nc à partir de cette source, comme défini dans pSchedule.

DS_REPADD_USE_COMPRESSION

Utilise la compression lors de la réplication. Cela permet d’économiser la bande passante réseau au détriment de la surcharge du processeur sur les serveurs source et de destination.

DS_REPADD_WRITEABLE

Crée un réplica accessible en écriture ; sinon, le réplica est en lecture seule.

Valeur retournée

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

Si la fonction échoue, la valeur de retour peut être l’une des suivantes.

Remarques

Notes

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

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