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