通过

DsQuerySitesByCostA 函数 （ntdsapi.h）

  • 项目

DsQuerySitesByCost 函数获取一个站点和一个或多个其他站点之间的通信成本。

语法

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

参数

[in] hDS

目录服务句柄。

pszFromSite

指向包含成本的站点的相对可分辨名称的以 null 结尾的字符串的指针。

rgszToSites

包含一个由 null 结尾的字符串指针数组，这些指针包含成本要测量到的站点的相对可分辨名称。

[in] cToSites

包含 rgwszToSites 数组中的元素数。

[in] dwFlags

保留。

[out] prgSiteInfo

指向接收成本数据的 DS_SITE_COST_INFO 结构的数组的指针。 此数组中的每个元素都包含由 pwszFromSite 参数标识的站点与由相应 rgwszToSites 元素标识的站点之间的成本数据。

调用方必须通过调用 DsQuerySitesFree来释放此内存。

返回值

如果成功或 Win32 或 RPC 错误代码，则返回 ERROR_SUCCESS 否则返回。 可能的错误代码包括以下列表中列出的值。

言论

此函数获取的成本值仅用于比较，本身没有意义。 例如，可以将站点 1 的成本与站点 2 的成本进行比较，但站点 1 的成本不能与固定值进行比较。

注意

ntdsapi.h 标头将 DsQuerySitesByCost 定义为一个别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将中性编码别名与不中性编码的代码混合使用可能会导致编译或运行时错误不匹配。 有关详细信息，请参阅函数原型的 约定。

要求

要求 价值
最低支持的客户端 Windows Vista
支持的最低服务器 Windows Server 2008
目标平台 窗户
标头 ntdsapi.h
库 Ntdsapi.lib
DLL Ntdsapi.dll

另请参阅

DS_SITE_COST_INFO

域控制器和复制管理功能

DsQuerySitesFree