DsReplicaSyncAllW, fonction (ntdsapi.h)
La fonction DsReplicaSyncAll synchronise un serveur avec tous les autres serveurs, en utilisant la réplication transitive, si nécessaire. Par défaut, DsReplicaSyncAll synchronise le serveur avec tous les autres serveurs de son site ; Toutefois, vous pouvez également l’utiliser pour synchroniser au-delà des limites du site.
Syntaxe
NTDSAPI DWORD DsReplicaSyncAllW(
[in] HANDLE hDS,
[in] LPCWSTR pszNameContext,
[in] ULONG ulFlags,
[in] BOOL(* )(LPVOID,PDS_REPSYNCALL_UPDATEW) pFnCallBack,
[in, optional] LPVOID pCallbackData,
[out, optional] PDS_REPSYNCALL_ERRINFOW **pErrors
);
Paramètres
[in] hDS
Contient un handle de service d’annuaire obtenu à partir de la fonction DSBind ou DSBindWithCred .
[in] pszNameContext
Pointeur vers une chaîne terminée par null qui spécifie le nom unique du contexte de nommage à synchroniser. Le paramètre pszNameContext est facultatif ; si sa valeur est NULL, le contexte de nommage de configuration est répliqué.
[in] ulFlags
Transmet les données supplémentaires utilisées pour traiter la demande. Ce paramètre peut être une combinaison des valeurs suivantes.
DS_REPSYNCALL_ABORT_IF_SERVER_UNAVAILABLE
Génère une erreur irrécupérable si un serveur ne peut pas être contacté ou si un serveur est inaccessible en raison d’une topologie déconnectée ou endommagée.
DS_REPSYNCALL_CROSS_SITE_BOUNDARIES
Synchronise par-delà les limites de site. Par défaut, DsReplicaSyncAll tente de se synchroniser uniquement avec les contrôleurs de domaine dans le même site que le système d’accueil. Définissez cet indicateur pour tenter de synchroniser avec tous les contrôleurs de domaine de la forêt d’entreprise. Toutefois, les contrôleurs de domaine peuvent être synchronisés uniquement s’ils sont connectés par un transport synchrone (RPC).
DS_REPSYNCALL_DO_NOT_SYNC
Désactive toute synchronisation. La topologie est toujours analysée et les serveurs indisponibles ou inaccessibles sont toujours identifiés.
DS_REPSYNCALL_ID_SERVERS_BY_DN
En cas d’erreur non irrécupérable, retourne des noms uniques de serveur (DN) au lieu de leurs noms DNS GUID.
DS_REPSYNCALL_NO_OPTIONS
Cette option n’a aucun effet.
DS_REPSYNCALL_PUSH_CHANGES_OUTWARD
Pousse les modifications du serveur local vers tous les partenaires à l'aide de la réplication transitive. Cela inverse le sens de la réplication et l’ordre d’exécution des ensembles de réplication à partir du mode d’exécution « pulling » habituel.
DS_REPSYNCALL_SKIP_INITIAL_CHECK
Suppose que tous les serveurs répondent. Cela accélère l’opération de la fonction DsReplicaSyncAll , mais si certains serveurs ne répondent pas, certaines réplications transitives peuvent être bloquées.
DS_REPSYNCALL_SYNC_ADJACENT_SERVERS_ONLY
Désactive la réplication transitive. La synchronisation est exécutée uniquement avec les serveurs adjacents.
[in] pFnCallBack
Pointeur vers une fonction SyncUpdateProc définie par l’application appelée par la fonction DsReplicaSyncAll lorsqu’elle rencontre une erreur, lance la synchronisation de deux serveurs, termine la synchronisation de deux serveurs ou termine la synchronisation de tous les serveurs du site.
[in, optional] pCallbackData
Pointeur vers les données définies par l’application passées comme premier argument de la fonction de rappel SyncUpdateProc pointée par le paramètre pFnCallBack .
[out, optional] pErrors
Tableau terminé par null de pointeurs vers
DS_REPSYNCALL_ERRINFO structures qui contiennent des erreurs qui se sont produites pendant la synchronisation. La mémoire utilisée pour contenir à la fois le tableau de pointeurs et les données MsCS\mscs\clusctl_resource_type_get_private_property_fmts.xml est allouée en tant que bloc de mémoire unique et doit être libérée lorsqu’elle n’est plus requise par un seul appel à LocalFree avec la valeur de pointeur retournée dans pErrors utilisée comme argument.
Valeur retournée
Si la fonction réussit, la valeur de retour est ERROR_SUCCESS.
Si la fonction échoue, la valeur de retour est la suivante.
Remarques
La fonction DsReplicaSyncAll tente de lier à tous les serveurs avant de générer une topologie à partir de laquelle effectuer la synchronisation. Si un serveur ne peut pas être contacté, la fonction exclut ce serveur de la topologie et tente de le contourner. La définition de l’indicateur DS_REPSYNCALL_SKIP_INITIAL_CHECK dans ulFlags contourne la liaison initiale.
Si un serveur ne peut pas être contacté, la fonction DsReplicaSyncAll tente de le contourner et de le répliquer à partir du plus grand nombre de serveurs possible, sauf si DS_REPSYNCALL_ABORT_IF_SERVER_UNAVAILABLE est défini dans ulFlags.
La fonction DsReplicaSyncAll peut utiliser la fonction de rappel pointée par pFnCallBack pour tenir un utilisateur final informé de la status actuelle de la réplication. L’exécution de la fonction DsReplicaSyncAll s’interrompt lorsqu’elle appelle la fonction pointée par pFnCallBack. Si la valeur de retour de la fonction de rappel est TRUE, la réplication continue ; sinon, la fonction DsReplicaSyncAll met fin à la réplication.
Notes
L’en-tête ntdsapi.h définit DsReplicaSyncAll 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 |
Voir aussi
Fonctions de gestion des contrôleurs de domaine et de la réplication
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour