функция ldap_parse_vlv_controlA (winldap.h)
Функция ldap_parse_vlv_control используется для поиска и анализа результатов поиска VLV.
Синтаксис
WINLDAPAPI INT LDAPAPI ldap_parse_vlv_controlA(
[in] PLDAP ExternalHandle,
[in] PLDAPControlA *Control,
[out] PULONG TargetPos,
[out] PULONG ListCount,
[out] PBERVAL *Context,
[out] PINT ErrCode
);
Параметры
[in] ExternalHandle
Дескриптор сеанса LDAP.
[in] Control
Адрес массива, завершаемого значением NULL, структур LDAPControl, обычно получаемых вызовом ldap_parse_result.
[out] TargetPos
Числовое положение целевой записи в списке результирующих наборов, как указано элементом targetPosition элемента управления ответов в кодировке BER (LDAP_CONTROL_VLVRESPONSE). Если этот параметр NULL, то целевая позиция не возвращается.
[out] ListCount
Сервер оценивает количество записей в списке, предоставляемых элементом contentCount элемента управления откликом в кодировке BER (LDAP_CONTROL_VLVRESPONSE). Если этот параметр значение NULL, размер не возвращается.
[out] Context
Идентификатор контекста, созданный сервером. Если сервер не возвращает идентификатор контекста, этот параметр будет иметь значение NULL. Если для контекста передается NULL, идентификатор контекста не возвращается.
[out] ErrCode
Код результата VLV, предоставляемый элементом virtualListViewResult элемента управления откликом в кодировке BER (LDAP_CONTROL_VLVRESPONSE). Если этот параметр null, то код результата не возвращается.
Возвращаемое значение
Эта функция возвращает код ошибки LDAP, указывающий, был ли обнаружен и успешно проанализирован элемент управления результатом VLV. LDAP_SUCCESS возвращается, если все идет хорошо, LDAP_CONTROL_MISSING возвращается, если ctrls массив не включает элемент управления ответом (LDAP_CONTROL_VLVRESPONSE), а другой код ошибки LDAP возвращается, если возникает ошибка синтаксического анализа или другая проблема.
VLV использует следующие коды возвращаемых значений LDAP:
LDAP_OPERATIONS_ERROR
LDAP_UNWILLING_TO_PERFORM
LDAP_INSUFFICIENT_ACCESS
LDAP_BUSY
LDAP_TIMELIMIT_EXCEEDED
LDAP_ADMINLIMIT_EXCEEDED
LDAP_OTHER
Кроме того, для поддержки VLV добавлены следующие два кода:
Замечания
Этот элемент управления анализирует результаты поиска, возвращаемые сервером в элементе управления ответа (LDAP_CONTROL_VLVRESPONSE). Идентификатор контекста передается от сервера клиенту для идентификации элемента управления, который должен быть освобожден в конце сеанса путем вызова ber_bvfree.
Дополнительные сведения и пример кода см. в разделе Пример кода для использования VLV LDAP.
Заметка
Заголовок winldap.h определяет ldap_parse_vlv_control как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.
Требования
| Требование | Ценность |
|---|---|
| минимальные поддерживаемые клиентские | Windows Vista |
| минимальный поддерживаемый сервер | Windows Server 2008 |
| целевая платформа | Виндоус |
| заголовка | winldap.h |
| библиотеки |
Wldap32.lib |
| DLL | Wldap32.dll |