функция ldap_first_reference (winldap.h)
Функция ldap_first_reference возвращает первую ссылку из сообщения.
Синтаксис
WINLDAPAPI LDAPMessage *LDAPAPI ldap_first_reference(
[in] LDAP *ld,
[in] LDAPMessage *res
);
Параметры
[in] ld
Дескриптор сеанса.
[in] res
Результат поиска, полученный при вызове одной из синхронных процедур поиска или ldap_result.
Возвращаемое значение
Если поиск вернул допустимые результаты, эта функция возвращает указатель на первую ссылку на результат. Если в результирующем наборе нет записи или ссылки, возвращается значение NULL. Это единственная ошибка, возвращаемая; Параметр ошибки сеанса в структуре данных LDAP в любом случае очищается до 0.
Комментарии
Используйте ldap_first_reference в сочетании с ldap_next_reference для пошагового выполнения и получения списка ссылок на продолжение из цепочки результатов поиска.
Функция возвращает подчиненные рефералы (ссылки), возвращаемые в ответах на поиск. Подчиненный реферал — это ссылка, в которой сервер вернул некоторые данные, а реферальная ссылка была передана в другие контексты именования ниже текущего уровня в дереве. Для пошагового просмотра внешних ссылок, в которых контекст именования не находится на сервере, используйте вместо этого ldap_parse_result .
Вам не нужно явным образом освобождать возвращенную ссылку, так как она освобождается при освобождении самого сообщения.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows Vista |
| Минимальная версия сервера | Windows Server 2008 |
| Целевая платформа | Windows |
| Header | winldap.h |
| Библиотека | Wldap32.lib |
| DLL | Wldap32.dll |