Fonction DsReplicaModifyA (ntdsapi.h)

Article
08/25/2023

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