Функция DsGetDcSiteCoverageA (dsgetdc.h)

Статья
11/20/2024

Функция DsGetDcSiteCoverage возвращает имена сайтов всех сайтов, охваченных контроллером домена.

Синтаксис

DSGETDCAPI DWORD DsGetDcSiteCoverageA(
  [in, optional] LPCSTR ServerName,
  [out]          PULONG EntryCount,
  [out]          LPSTR  **SiteNames
);

Параметры

[in, optional] ServerName

Строковое значение, завершающее значение NULL, указывающее имя удаленного контроллера домена.

[out] EntryCount

Указатель на значение ULONG, которое получает количество сайтов, охваченных контроллером домена.

[out] SiteNames

Указатель на массив указателей на строки, завершающиеся значением NULL, которые получают имена сайтов. Чтобы освободить возвращенный буфер, вызовите функцию NetApiBufferFree.

Возвращаемое значение

Эта функция возвращает DWORD DSGETDCAPI.

Замечания

Заметка

Заголовок dsgetdc.h определяет DsGetDcSiteCoverage как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows Vista
минимальный поддерживаемый сервер	Windows Server 2008
целевая платформа	Виндоус
заголовка	dsgetdc.h
библиотеки	Netapi32.lib
DLL	Netapi32.dll

См. также

функций службы каталогов

DsGetSiteName

NetApiBufferFree

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