Fonction DsReplicaModifyA (ntdsapi.h)
La fonction DsReplicaModify modifie une référence de source de réplication existante pour un contexte de nommage de destination.
Syntaxe
NTDSAPI DWORD DsReplicaModifyA(
[in] HANDLE hDS,
[in] LPCSTR NameContext,
[in] const UUID *pUuidSourceDsa,
[in] LPCSTR TransportDn,
[in] LPCSTR SourceDsaAddress,
[in] const PSCHEDULE pSchedule,
[in] DWORD ReplicaFlags,
[in] DWORD ModifyFields,
[in] DWORD 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 null qui spécifie le nom unique (DN) du contexte de nommage de destination (NC).
[in] pUuidSourceDsa
Pointeur vers l’UUID de l’agent système de répertoire source (DSA). Ce paramètre peut avoir la valeur Null si ModifyFields n’inclut pas DS_REPMOD_UPDATE_ADDRESS et si SourceDsaAddress n’a pas la valeur NULL.
[in] TransportDn
Réservé pour un usage futur. Toute valeur autre que NULL entraîne le retour de ERROR_NOT_SUPPORTED .
[in] SourceDsaAddress
Pointeur vers une chaîne Unicode terminée par une valeur null constante qui spécifie l’adresse spécifique au transport de l’authentification DSA source. Ce paramètre est ignoré si pUuidSourceDsa n’a pas la valeur NULL et ModifyFields n’inclut pas DS_REPMOD_UPDATE_ADDRESS.
[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é. Ce paramètre est obligatoire si ModifyFields contient l’indicateur DS_REPMOD_UPDATE_SCHEDULE .
[in] ReplicaFlags
Ce paramètre est utilisé pour contrôler le comportement de réplication et peut prendre les valeurs suivantes.
DS_REPL_NBR_SYNC_ON_STARTUP
La réplication de ce contexte de nommage à partir de cette source est tentée lorsque le serveur de destination est démarré. Cela ne s'applique normalement qu'aux voisins intra-sites.
DS_REPL_NBR_DO_SCHEDULED_SYNCS
Exécuter la réplication selon une planification. Cet indicateur est normalement défini, sauf si la planification de ce contexte de nommage et de cette source n’est « jamais », c’est-à-dire la planification vide.
DS_REPL_NBR_TWO_WAY_SYNC
Si la valeur est définie, indique que lorsque la réplication entrante est terminée, le serveur de destination doit indiquer au serveur source de se synchroniser dans le sens inverse. Cette fonctionnalité est utilisée dans les scénarios d'accès à distance dans lesquels un seul des deux serveurs peut initier une connexion d'accès à distance. Par exemple, cette option serait utilisée dans un siège social d'entreprise et une filiale, où la filiale se connecte au siège social par le biais d'Internet au moyen d'une connexion d'accès à distance de fournisseur de services Internet.
DS_REPL_NBR_IGNORE_CHANGE_NOTIFICATIONS
Ce voisin est défini pour désactiver la synchronisation basée sur la notification. Dans un site, les contrôleurs de domaine se synchronisent les uns avec les autres en fonction des notifications lorsque des modifications se produisent. Ce paramètre empêche ce voisin d’effectuer une synchronisation déclenchée par une notification. Le voisin effectue toujours la synchronisation en fonction de sa planification ou en réponse à la synchronisation demandée manuellement.
DS_REPL_NBR_DISABLE_SCHEDULED_SYNC
Ce voisin est défini pour ne pas effectuer la synchronisation en fonction de sa planification. La seule façon pour ce voisin d’effectuer la synchronisation consiste à répondre aux notifications de modification ou à la synchronisation demandée manuellement.
DS_REPL_NBR_COMPRESS_CHANGES
Les modifications reçues de cette source doivent être compressées. Cette valeur est normalement définie si, et uniquement si, le serveur source se trouve sur un autre site.
DS_REPL_NBR_NO_CHANGE_NOTIFICATIONS
Aucune notification de modification ne doit être reçue à partir de cette source. Cette valeur est normalement définie si, et uniquement si, le serveur source se trouve sur un autre site.
[in] ModifyFields
Spécifie les champs à modifier. Au moins un champ doit être spécifié dans ModifyFields. Ce paramètre peut être une combinaison des valeurs suivantes.
DS_REPMOD_UPDATE_ADDRESS
Mises à jour l’adresse associée au serveur référencé.
DS_REPMOD_UPDATE_FLAGS
Mises à jour les indicateurs associés au réplica.
DS_REPMOD_UPDATE_RESULT
Non utilisé. La spécification des mises à jour des valeurs de résultat n’est actuellement pas prise en charge. Les valeurs de résultat sont par défaut 0.
DS_REPMOD_UPDATE_SCHEDULE
Mises à jour la planification de réplication périodique associée au réplica.
DS_REPMOD_UPDATE_TRANSPORT
Mises à jour le transport associé au réplica.
[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_REPMOD_ASYNCHRONOUS_OPERATION
Effectue cette opération de manière asynchrone.
DS_REPMOD_WRITEABLE
Indique que le réplica en cours de modification 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 peut être l’une des suivantes.
Remarques
Notes
L’en-tête ntdsapi.h définit DsReplicaModify 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 |
Voir aussi
Fonctions de gestion du contrôleur de domaine et de la réplication