Функция DsQuerySitesByCostA (ntdsapi.h)

Статья
03/09/2024

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

Share via