Fonction DsReplicaSyncA (ntdsapi.h)

Article
08/25/2023

La fonction DsReplicaSync synchronise un contexte de nommage de destination (NC) avec l’une de ses sources.

Syntaxe

NTDSAPI DWORD DsReplicaSyncA(
  [in] HANDLE     hDS,
  [in] LPCSTR     NameContext,
  [in] const UUID *pUuidDsaSrc,
  [in] ULONG      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 caractère Null qui spécifie le nom unique du nc de destination.

[in] pUuidDsaSrc

Pointeur vers l’UUID d’une source qui réplique vers le nc de destination.

[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_REPSYNC_ADD_REFERENCE

Oblige l’agent système d’annuaire source (DSA) à vérifier que l’agent DSA local est présent dans la liste des répliqués sources. Si ce n’est pas le cas, le DSA local est ajouté. Cela garantit que la source envoie des notifications de modification.

DS_REPSYNC_ALL_SOURCES

Cette valeur n’est pas prise en charge.

Windows Server 2008 R2, Windows 7, Windows Server 2008, Windows Vista et Windows Server 2003 : Synchronise à partir de toutes les sources.

DS_REPSYNC_ASYNCHRONOUS_OPERATION

Effectue cette opération de manière asynchrone.

Windows Server 2008 R2, Windows 7, Windows Server 2008, Windows Vista et Windows Server 2003 : Obligatoire lors de l’utilisation de DS_REPSYNC_ALL_SOURCES.

DS_REPSYNC_FORCE

Se synchronise même si le lien est actuellement désactivé.

DS_REPSYNC_FULL

Se synchronise à partir du premier numéro de séquence de mise à jour (USN).

DS_REPSYNC_INTERSITE_MESSAGING

Synchronise à l’aide d’un ISM.

DS_REPSYNC_NO_DISCARD

N’ignore pas cette demande de synchronisation, même si une synchronisation similaire est en attente.

DS_REPSYNC_PERIODIC

Indique que cette opération est une demande de synchronisation périodique planifiée par l’administrateur.

DS_REPSYNC_URGENT

Indique que cette opération est une notification d’une mise à jour marquée comme urgente.

DS_REPSYNC_WRITEABLE

Le réplica est accessible en écriture. Sinon, il est en lecture seule.

Valeur retournée

Si la fonction effectue correctement son opération, la valeur de retour est ERROR_SUCCESS.

Si la fonction échoue, la valeur de retour est l’une des erreurs standard de l’API Win32.

Remarques

Le serveur sur lequel DsReplicaSync s’exécute est appelé la destination. Le contexte de nommage de destination est mis à jour par rapport à un système source, identifié par l’UUID de l’objet NTDS Settings du système source. Le système de destination doit déjà être configuré pour que le système source soit l’un des systèmes à partir desquels il reçoit des données de réplication.

Note Forcer la synchronisation manuelle peut empêcher le service d’annuaire de hiérarchiser correctement les opérations de réplication. Par exemple, la synchronisation d’un nouvel utilisateur peut préempter une synchronisation urgente effectuée pour fournir l’accès à un utilisateur récemment verrouillé ou pour ajouter un nouveau mot de passe d’approbation. Si vous appelez souvent cette API, vous pouvez inonder le réseau de requêtes, ce qui peut interférer avec d’autres opérations de réplication. Pour cette raison, il est fortement recommandé d’utiliser cette fonction uniquement pour les scénarios à usage unique plutôt que de l’incorporer dans une application qui l’utiliserait régulièrement.

Notes

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