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
目標平台	Windows
標頭	ntdsapi.h
程式庫	Ntdsapi.lib
Dll	Ntdsapi.dll

另請參閱

DS_SITE_COST_INFO

域控制器和復寫管理功能

DsQuerySitesFree