Поделиться через


Функция 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

См. также раздел

DS_SITE_COST_INFO

Функции управления контроллером домена и репликацией

DsQuerySitesFree