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 |