Fonction DsQuerySitesByCostA (ntdsapi.h)

Article
03/04/2024

La fonction DsQuerySitesByCost obtient le coût de communication entre un site et un ou plusieurs autres sites.

Syntaxe

NTDSAPI_POSTXP DWORD DsQuerySitesByCostA(
  [in]  HANDLE             hDS,
        LPSTR              pszFromSite,
        LPSTR              *rgszToSites,
  [in]  DWORD              cToSites,
  [in]  DWORD              dwFlags,
  [out] PDS_SITE_COST_INFO *prgSiteInfo
);

Paramètres

[in] hDS

Un handle de service d’annuaire.

pszFromSite

Pointeur vers une chaîne terminée par null qui contient le nom unique relatif du site à partir duquel les coûts sont mesurés.

rgszToSites

Contient un tableau de pointeurs de chaînes terminés par null qui contiennent les noms uniques relatifs des sites où les coûts sont mesurés.

[in] cToSites

Contient le nombre d’éléments dans le tableau rgwszToSites .

[in] dwFlags

Réservé.

[out] prgSiteInfo

Pointeur vers un tableau de structures DS_SITE_COST_INFO qui reçoit les données de coût. Chaque élément de ce tableau contient les données de coût entre le site identifié par le paramètre pwszFromSite et le site identifié par l’élément rgwszToSites correspondant.

L’appelant doit libérer cette mémoire lorsqu’elle n’est plus nécessaire en appelant DsQuerySitesFree.

Valeur retournée

Retourne ERROR_SUCCESS en cas de réussite ou un code d’erreur Win32 ou RPC dans le cas contraire. Les codes d’erreur possibles incluent les valeurs répertoriées dans la liste suivante.

Remarques

Les valeurs de coût obtenues par cette fonction sont utilisées uniquement pour comparer et n’ont aucune signification par elles-mêmes. Par exemple, le coût du site 1 peut être comparé au coût du site 2, mais le coût du site 1 ne peut pas être comparé à une valeur fixe.

Notes

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

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

DS_SITE_COST_INFO

Fonctions de gestion du contrôleur de domaine et de la réplication

DsQuerySitesFree

Partager via