DsQuerySitesByCostA, fonction (ntdsapi.h)

Article
11/20/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

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îne null qui contiennent les noms uniques relatifs des sites auxquels 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 le rgwszToSites correspondant élément.

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

Valeur de retour

Retourne ERROR_SUCCESS en cas de réussite ou d’un code d’erreur Win32 ou RPC dans le cas contraire. Les codes d’erreur possibles incluent des 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 eux-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.

Note

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

DS_SITE_COST_INFO

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

DsQuerySitesFree

Partager via