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