DsReplicaUpdateRefsA, fonction (ntdsapi.h)

Article
03/04/2024

La fonction DsReplicaUpdateRefs ajoute ou supprime une référence de réplication pour une destination d’un contexte de nommage source.

Syntaxe

NTDSAPI DWORD DsReplicaUpdateRefsA(
  [in] HANDLE     hDS,
  [in] LPCSTR     NameContext,
  [in] LPCSTR     DsaDest,
  [in] const UUID *pUuidDsaDest,
  [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 contexte de nommage source.

[in] DsaDest

Pointeur vers une chaîne constante terminée par un caractère Null qui spécifie l’adresse spécifique au transport de l’agent système d’annuaire de destination.

[in] pUuidDsaDest

Pointeur vers une valeur UUID qui contient l’agent système d’annuaire de destination.

[in] Options

Contient un ensemble d’indicateurs qui fournissent des données supplémentaires utilisées pour traiter la demande. Il peut s’agir de zéro ou d’une combinaison d’une ou plusieurs des valeurs suivantes.

DS_REPUPD_ADD_REFERENCE

Une référence à la destination est ajoutée au serveur source.

DS_REPUPD_ASYNCHRONOUS_OPERATION

L’opération est effectuée de manière asynchrone.

DS_REPUPD_DELETE_REFERENCE

Une référence à la destination est supprimée du serveur source.

DS_REPUPD_WRITEABLE

La référence aux réplica ajoutées ou supprimées est accessible en écriture. Sinon, il est en lecture seule.

Valeur retournée

Si la fonction réussit, ERROR_SUCCESS est retournée.

Si la fonction échoue, la valeur de retour peut être l’une des suivantes.

Remarques

Si DS_REPUPD_ADD_REFERENCE et DS_REPUPD_DELETE_REFERENCE sont définis dans le paramètre Options , une référence à la destination est ajoutée si elle n’existe pas déjà sur le serveur. Si une référence à la destination existe déjà, la référence est mise à jour.

Notes

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