DsReplicaUpdateRefsA, fonction (ntdsapi.h)
La fonction DsReplicaUpdateRefs ajoute ou supprime une référence de réplication pour une destination à partir d’un contexte d’affectation de noms 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
[in] NameContext
Pointeur vers une chaîne constante terminée par null qui spécifie le nom unique du contexte de nommage source.
[in] DsaDest
Pointeur vers une chaîne constante terminée par null qui spécifie l’adresse spécifique au transport de l’agent système de répertoire de destination.
[in] pUuidDsaDest
Pointeur vers une valeur UUID qui contient l’agent système de répertoire 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 au réplica ajouté ou supprimé est accessible en écriture. Sinon, il est en lecture seule.
Valeur de retour
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 les DS_REPUPD_ADD_REFERENCE et les 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.
Note
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. 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