Fonction DsReplicaGetInfoW (ntdsapi.h)

Article
08/25/2023

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