DsReplicaModifyA, fonction (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
[in] NameContext
Pointeur vers une chaîne constante terminée par null qui spécifie le nom unique (DN) du contexte de nommage de destination (NC).
[in] pUuidSourceDsa
Pointeur vers l’UUID de l’agent de système d’annuaire source (DSA). Ce paramètre peut être null si ModifyFields n’inclut pas DS_REPMOD_UPDATE_ADDRESS et SourceDsaAddress n’est pas NULL.
[in] TransportDn
Réservé pour une utilisation ultérieure. Toute valeur autre que NULL entraîne le retour de ERROR_NOT_SUPPORTED.
[in] SourceDsaAddress
Pointeur vers une chaîne Unicode terminée par null constante qui spécifie l’adresse spécifique au transport de la DSA source. Ce paramètre est ignoré si pUuidSourceDsa n’est pas 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 de 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 s’applique normalement uniquement aux voisins intra-sites.
DS_REPL_NBR_DO_SCHEDULED_SYNCS
Effectuez la réplication selon une planification. Cet indicateur est normalement défini, sauf si la planification de ce contexte d’affectation de noms et que la source n’est « jamais », autrement dit, la planification vide.
DS_REPL_NBR_TWO_WAY_SYNC
Si elle 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 où un seul des deux serveurs peut lancer une connexion rendez-vous. Par exemple, cette option serait utilisée dans un siège social et une succursale d’entreprise, où le bureau de succursale se connecte au siège social de l’entreprise via Internet par le biais d’une connexion isP rendez-vous.
DS_REPL_NBR_IGNORE_CHANGE_NOTIFICATIONS
Ce voisin est défini pour désactiver la synchronisation basée sur les notifications. Dans un site, les contrôleurs de domaine se synchronisent 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 dont ce voisin effectue la synchronisation est en réponse 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. Cela est normalement défini si, et seulement si, le serveur source se trouve dans un autre site.
DS_REPL_NBR_NO_CHANGE_NOTIFICATIONS
Aucune notification de modification ne doit être reçue de cette source. Cela est normalement défini si, et seulement si, le serveur source se trouve dans 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
Met à jour l’adresse associée au serveur référencé.
DS_REPMOD_UPDATE_FLAGS
Met à 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 par défaut sont 0.
DS_REPMOD_UPDATE_SCHEDULE
Met à jour la planification de réplication périodique associée au réplica.
DS_REPMOD_UPDATE_TRANSPORT
Met à jour le transport associé au réplica.
[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_REPMOD_ASYNCHRONOUS_OPERATION
Effectue cette opération de façon asynchrone.
DS_REPMOD_WRITEABLE
Indique que le réplica en cours de modification 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 peut être l’une des suivantes.
Remarques
Note
L’en-tête ntdsapi.h définit DsReplicaModify 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