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

Статья
11/20/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
целевая платформа	Виндоус
заголовка	ntdsapi.h
библиотеки	Ntdsapi.lib
DLL	Ntdsapi.dll

См. также

DS_SITE_COST_INFO

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

DsQuerySitesFree

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