функция ldap_result (winldap.h)
Функция ldap_result получает результат асинхронной операции.
Синтаксис
WINLDAPAPI ULONG LDAPAPI ldap_result(
[in] LDAP *ld,
[in] ULONG msgid,
[in] ULONG all,
[in] PLDAP_TIMEVAL timeout,
[out] PLDAPMessage *res
);
Параметры
[in] ld
Дескриптор сеанса.
[in] msgid
Идентификатор сообщения операции или константный LDAP_RES_ANY, если требуется какой-либо результат.
[in] all
Указывает, сколько сообщений извлекается в одном вызове ldap_result. Этот параметр имеет значение только для результатов поиска. Передайте константную LDAP_MSG_ONE (0x00), чтобы получить по одному сообщению за раз. Передайте LDAP_MSG_ALL (0x01), чтобы запросить получение всех результатов поиска перед возвратом всех результатов в одной цепочке. Передайте LDAP_MSG_RECEIVED (0x02), чтобы указать, что все полученные результаты должны возвращаться в цепочке результатов.
[in] timeout
Время ожидания, указывающее, как долго (в секундах) следует ожидать возврата результатов. Значение NULL приводит к тому, что ldap_result блокируется до тех пор, пока результаты не будут доступны. Значение времени ожидания, равное нулю секунд, указывает поведение опроса.
[out] res
Содержит результаты операции. Все возвращаемые результаты должны быть освобождены с помощью вызова ldap_msgfree как только они больше не требуются приложению.
Возвращаемое значение
Если функция завершается успешно, она возвращает одно из следующих значений, чтобы указать тип первого результата в параметре res . Если истекает время ожидания, функция возвращает значение 0.
Если функция завершается сбоем, она возвращает –1 и задает параметры ошибки сеанса в структуре данных LDAP.
Комментарии
Функция ldap_result извлекает результат предыдущей асинхронно инициированной операции. Имейте в виду, что в зависимости от способа его вызова ldap_result может фактически возвращать список или "цепочку" сообщений.
Для протокола LDAP без подключения необходимо передать как дескриптор подключения LDAP, так и идентификатор сообщения, чтобы получить правильные результаты. Время выполнения LDAP продолжает отправлять запрос до получения ответа.
Многопоточность. Вызовы к ldap_result являются потокобезопасны.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows Vista |
| Минимальная версия сервера | Windows Server 2008 |
| Целевая платформа | Windows |
| Header | winldap.h |
| Библиотека | Wldap32.lib |
| DLL | Wldap32.dll |