función ldap_get_next_page (winldap.h)
La función ldap_get_next_page devuelve la página siguiente en una secuencia de resultados de búsqueda paginados asincrónicos.
Sintaxis
WINLDAPAPI ULONG LDAPAPI ldap_get_next_page(
[in] PLDAP ExternalHandle,
[in] PLDAPSearch SearchHandle,
[in] ULONG PageSize,
[out] ULONG *MessageNumber
);
Parámetros
[in] ExternalHandle
Identificador de sesión.
[in] SearchHandle
Identificador de bloque de búsqueda.
[in] PageSize
Número de entradas que se van a devolver en una sola página.
[out] MessageNumber
Identificador del mensaje de la solicitud.
Valor devuelto
Si la función se ejecuta correctamente, el valor devuelto es LDAP_SUCCESS.
Si se produce un error en la función, devuelve un valor devuelto de código de error. Para obtener más información, vea Valores devueltos.
Comentarios
La función ldap_get_next_page forma parte de la interfaz para la paginación simple y asincrónica de los resultados de búsqueda. Use el identificador de búsqueda devuelto desde una llamada inicial para ldap_search_init_page y especifique, en el parámetro PageSize , el número de entradas que se devolverán en una página. Establezca PageSize en cero para abandonar una búsqueda.
Tenga en cuenta que, después de cada llamada a ldap_get_next_page, debe llamar a ldap_get_paged_count para cada conjunto de resultados devueltos desde el servidor mediante ldap_result. Esto permite que el tiempo de ejecución de LDAP guarde la cookie que el servidor ha pasado para mantener el estado de búsqueda. Aparte de llamar a ldap_get_paged_count, los resultados devueltos de ldap_get_next_page se pueden controlar como cualquier otro resultado de búsqueda y deben liberarse cuando se completen llamando a ldap_msgfree.
Al analizar el conjunto de resultados, tenga en cuenta que es posible que el servidor devuelva una página vacía de resultados y, sin embargo, siga respondiendo con un valor devuelto LDAP_SUCCESS . Esto indica que el servidor no pudo recuperar una página de resultados, debido a un tiempo de espera u otro motivo, pero no ha finalizado la solicitud de búsqueda. El comportamiento adecuado, en este caso, es continuar llamando a ldap_get_next_page hasta que se recupera correctamente otra página de resultados, se devuelve un código de error o se devuelve LDAP_NO_RESULTS_RETURNED para indicar que se ha completado la búsqueda.
Si prefiere recuperar los resultados de búsqueda paginados de forma sincrónica, use ldap_get_next_page_s.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows Vista |
| Servidor mínimo compatible | Windows Server 2008 |
| Plataforma de destino | Windows |
| Encabezado | winldap.h |
| Library | Wldap32.lib |
| Archivo DLL | Wldap32.dll |