Функция DsAddressToSiteNamesExA (dsgetdc.h)
Функция DsAddressToSiteNamesEx получает имена сайтов и подсетей, соответствующие указанным адресам.
Синтаксис
DSGETDCAPI DWORD DsAddressToSiteNamesExA(
[in, optional] LPCSTR ComputerName,
[in] DWORD EntryCount,
[in] PSOCKET_ADDRESS SocketAddresses,
[out] LPSTR **SiteNames,
[out] LPSTR **SubnetNames
);
Параметры
[in, optional] ComputerName
Указатель на строку, завершающую значение NULL, которая указывает имя удаленного сервера для обработки этой функции. Этот параметр должен быть именем контроллера домена. Контроллер, отличный от домена, может вызывать эту функцию, вызывая DsGetDcName для поиска контроллера домена.
[in] EntryCount
Содержит количество элементов в массиве SocketAddresses.
[in] SocketAddresses
Содержит массив структур SOCKET_ADDRESS, содержащих адреса для преобразования. Каждый адрес в этом массиве должен иметь тип AF_INET. EntryCount содержит количество элементов в этом массиве.
[out] SiteNames
Получает массив строковых указателей, завершающих значение NULL, которые содержат имена сайтов для адресов. Каждый элемент в этом массиве соответствует одному элементу в массиве SocketAddresses. Элемент NULL, если соответствующий адрес не сопоставляется с каким-либо известным сайтом или если запись адреса не соответствует правильной форме. Вызывающий объект должен освободить этот массив, если он больше не требуется путем вызова NetApiBufferFree.
[out] SubnetNames
Получает массив строковых указателей, завершающих значение NULL, которые содержат имена подсетей, используемые для выполнения сопоставлений имен сайта. Каждый элемент в этом массиве соответствует одному элементу в массиве SocketAddresses. Элемент NULL, если соответствующий адрес сопоставления имен сайта не определен или если для сопоставления сайтов не использовался соответствующий адрес. Последний будет в том случае, если в организации нет ни одного сайта без объектов подсети, сопоставленных с ним. Вызывающий объект должен освободить этот массив, если он больше не требуется путем вызова NetApiBufferFree.
Возвращаемое значение
Возвращает NO_ERROR, если ошибка Win32 или RPC успешно выполнена в противном случае. Ниже приведены возможные коды ошибок.
Замечания
Заметка
Заголовок dsgetdc.h определяет DsAddressToSiteNamesEx в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.
Требования
| Требование | Ценность |
|---|---|
| минимальные поддерживаемые клиентские | Windows Vista |
| минимальный поддерживаемый сервер | Windows Server 2008 |
| целевая платформа | Виндоус |
| заголовка | dsgetdc.h |
| библиотеки |
Netapi32.lib |
| DLL | Netapi32.dll |
См. также
функций службы каталогов