DsReplicaSyncA, fonction (ntdsapi.h)

Article
11/20/2024

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 null qui spécifie le nom unique du nc de destination.

[in] pUuidDsaSrc

Pointeur vers l’UUID d’une source qui est répliquée vers le contrôleur de réseau de destination.

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

Provoque la présence de l’agent système d’annuaire source (DSA) pour vérifier que la DSA locale est présente dans la liste des répliquées sources. Si ce n’est pas le cas, la DSA locale est ajoutée. 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 façon 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

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

DS_REPSYNC_FULL

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

DS_REPSYNC_INTERSITE_MESSAGING

Se 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 comme prévu 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 de retour

Si la fonction effectue son opération avec succès, la valeur de retour est ERROR_SUCCESS.

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

Remarques

Le serveur sur lequel DsReplicaSync s’exécute est appelé destination. Le contexte de nommage de destination est apporté up-to-date 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é afin que le système source soit l’un des systèmes à partir desquels il reçoit des données de réplication.

Remarque 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éempiter 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 avec des 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.

Note

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

DsReplicaAdd

DsReplicaDel

DsReplicaModify

DsReplicaUpdateRefs

Partager via