共用方式為

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 標頭會根據 UNICODE 預處理器常數的定義，將 DsQuerySitesByCost 定義為自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。 如需詳細資訊，請參閱函式原型的 慣例。

要求

要求 價值
最低支援的用戶端 Windows Vista
支援的最低伺服器 Windows Server 2008
目標平臺 窗戶
標頭 ntdsapi.h
連結庫 Ntdsapi.lib
DLL Ntdsapi.dll

另請參閱

DS_SITE_COST_INFO

域控制器和復寫管理功能

DsQuerySitesFree