Fonction DsReplicaGetInfoW (ntdsapi.h)
La fonction DsReplicaGetInfo récupère les données d’état de réplication à partir du service d’annuaire.
Syntaxe
NTDSAPI DWORD DsReplicaGetInfoW(
[in] HANDLE hDS,
[in] DS_REPL_INFO_TYPE InfoType,
[in, optional] LPCWSTR pszObject,
[in, optional] UUID *puuidForSourceDsaObjGuid,
[out] VOID **ppInfo
);
Paramètres
[in] hDS
Contient un handle de service d’annuaire obtenu à partir de la fonction DSBind ou DSBindWithCred .
[in] InfoType
Contient l’une des valeurs DS_REPL_INFO_TYPE qui spécifie le type de données de réplication à récupérer. Cette valeur détermine également le type de structure retourné dans ppInfo.
Seules les valeurs suivantes sont prises en charge pour cette fonction. Si d’autres types de données sont requis, la fonction DsReplicaGetInfo2 doit être utilisée.
DS_REPL_INFO_NEIGHBORS
DS_REPL_INFO_CURSORS_FOR_NC
DS_REPL_INFO_METADATA_FOR_OBJ
DS_REPL_INFO_KCC_DSA_CONNECT_FAILURES
DS_REPL_INFO_KCC_DSA_LINK_FAILURES
DS_REPL_INFO_PENDING_OPS
[in, optional] pszObject
Pointeur vers une chaîne Unicode terminée par null constante qui identifie l’objet pour lequel récupérer les données de réplication. La signification de ce paramètre dépend de la valeur du paramètre InfoType . Voici les codes de valeur possibles.
DS_REPL_INFO_NEIGHBORS
pszObject identifie le contexte de nommage pour lequel les voisins de réplication sont demandés.
DS_REPL_INFO_CURSORS_FOR_NC
pszObject identifie le contexte de nommage pour lequel les curseurs de réplication sont demandés.
DS_REPL_INFO_METADATA_FOR_OBJ
pszObject identifie l’objet pour lequel les métadonnées de réplication sont demandées.
DS_REPL_INFO_KCC_DSA_CONNECT_FAILURES
pszObject doit avoir la valeur NULL.
DS_REPL_INFO_KCC_DSA_LINK_FAILURES
pszObject doit avoir la valeur NULL.
DS_REPL_INFO_PENDING_OPS
pszObject doit avoir la valeur NULL.
[in, optional] puuidForSourceDsaObjGuid
Pointeur vers une valeur GUID qui identifie une source de réplication spécifique. Si ce paramètre n’a pas la valeur NULL et que le paramètre InfoType contient DS_REPL_INFO_NEIGHBORS, seules les données voisines de la source correspondant à l’objet nTDSDSA avec l’objetGuid donné dans le répertoire sont retournées. Ce paramètre est ignoré si null ou si le paramètre InfoType est autre que DS_REPL_INFO_NEIGHBORS.
[out] ppInfo
Adresse d’un pointeur de structure qui reçoit les données demandées. La valeur du paramètre InfoType détermine le format de cette structure. Pour plus d’informations et la liste des valeurs InfoType possibles et des types de structure correspondants, consultez DS_REPL_INFO_TYPE.
L’appelant doit libérer cette mémoire quand elle n’est plus nécessaire en appelant DsReplicaFreeInfo.
Valeur retournée
Retourne ERROR_SUCCESS en cas de réussite ou une erreur Win32 ou RPC dans le cas contraire. Voici les codes d’erreur possibles.
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 du contrôleur 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