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

Статья
11/20/2024

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

Синтаксис

DSGETDCAPI DWORD DsAddressToSiteNamesA(
  [in, optional] LPCSTR          ComputerName,
  [in]           DWORD           EntryCount,
  [in]           PSOCKET_ADDRESS SocketAddresses,
  [out]          LPSTR           **SiteNames
);

Параметры

[in, optional] ComputerName

Указатель на строку, завершающую значение NULL, которая указывает имя удаленного сервера для обработки этой функции. Этот параметр должен быть именем контроллера домена. Контроллер, отличный от домена, может вызывать эту функцию, вызывая DsGetDcName для поиска контроллера домена.

[in] EntryCount

Содержит количество элементов в массиве SocketAddresses.

[in] SocketAddresses

Содержит массив структур SOCKET_ADDRESS, содержащих адреса для преобразования. Каждый адрес в этом массиве должен иметь тип AF_INET. EntryCount содержит количество элементов в этом массиве.

[out] SiteNames

Получает массив строковых указателей, завершающих значение NULL, которые содержат имена сайтов для адресов. Каждый элемент в этом массиве соответствует одному элементу в массиве SocketAddresses. Элемент NULL, если соответствующий адрес не сопоставляется с каким-либо известным сайтом или если запись адреса не соответствует правильной форме. Вызывающий объект должен освободить этот массив, если он больше не требуется путем вызова NetApiBufferFree.

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

Возвращает NO_ERROR, если ошибка Win32 или RPC успешно выполнена в противном случае. В следующем списке перечислены возможные коды ошибок.

Замечания

Заметка

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

Требования

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

См. также

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

DsAddressToSiteNamesEx

DsGetDcName

NetApiBufferFree

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