Partager via


DsReplicaAddW, fonction (ntdsapi.h)

La fonction DsReplicaAdd ajoute une référence de source de réplication à un contexte d’affectation de noms 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 en tant qu’objet, instancié ou non, ou 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 nom de domaine du objet NTDS-DSA pour l’agent système d’annuaire source. Ce paramètre est requis si Options inclut DS_REPADD_ASYNCHRONOUS_REPLICA; sinon, elle est ignorée.

[in] TransportDn

Chaîne terminée par null qui spécifie le nom de domaine 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 la DSA 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 façon asynchrone.

DS_REPADD_ASYNCHRONOUS_REPLICA

Ne réplique pas le contrôleur de réseau. Au lieu de cela, enregistrez suffisamment de données d’état afin qu’elles puissent être répliquées ultérieurement.

DS_REPADD_DISABLE_NOTIFICATION

Désactive la synchronisation basée sur les notifications pour le contrôleur de réseau à 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 contrôleur de réseau à partir de cette source.

DS_REPADD_INITIAL

Synchronise le contrôleur de réseau à partir de cette source au démarrage de la DSA.

DS_REPADD_INTERSITE_MESSAGING

Se synchronise à partir de la DSA source à l’aide du transport IMS (Intersite Messaging Service), par exemple par SMTP, au lieu d’utiliser le 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. Il est recommandé pour toutes les réplications intersite qui peuvent se produire sur des liens 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 contrôleur de réseau à 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 de 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 de retour

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

Note

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

Voir aussi

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

DsReplicaDel

DsReplicaModify

DsReplicaSync

DsReplicaUpdateRefs

SCHEDULE