DsReplicaAddA, 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 DsReplicaAddA(
[in] HANDLE hDS,
[in] LPCSTR NameContext,
[in] LPCSTR SourceDsaDn,
[in] LPCSTR TransportDn,
[in] LPCSTR SourceDsaAddress,
[in] const PSCHEDULE pSchedule,
[in] DWORD Options
);
Paramètres
[in] hDS
Contient un handle de service d’annuaire obtenu à partir de la fonction
[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