Функция 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.
Возвращаемое значение
Возвращает ERROR_SUCCESS в случае успешного выполнения или код ошибки Win32 или RPC в противном случае. Возможные коды ошибок включают значения, перечисленные в следующем списке.
Комментарии
Значения затрат, полученные этой функцией, используются только для сравнения и сами по себе не имеют смысла. Например, затраты на сайт 1 можно сравнить со стоимостью для сайта 2, но стоимость сайта 1 не может сравниваться с фиксированным значением.
Примечание
Заголовок ntdsapi.h определяет DsQuerySitesByCost как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОД. Сочетание использования псевдонима, не зависящий от кодировки, с кодом, не зависящим от кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows Vista |
| Минимальная версия сервера | Windows Server 2008 |
| Целевая платформа | Windows |
| Header | ntdsapi.h |
| Библиотека | Ntdsapi.lib |
| DLL | Ntdsapi.dll |