función ldap_parse_page_control (winldap.h)
El ldap_parse_page_control analiza los resultados de una búsqueda en páginas.
Sintaxis
WINLDAPAPI ULONG LDAPAPI ldap_parse_page_control(
[in] PLDAP ExternalHandle,
[in] PLDAPControlA *ServerControls,
[out] ULONG *TotalCount,
[out] berval **Cookie
);
Parámetros
[in] ExternalHandle
Identificador de sesión.
[in] ServerControls
Matriz de controles que incluye un control de página. El control de página contiene los campos cookie y recuento total devueltos por el servidor.
[out] TotalCount
Puntero al recuento total de entradas devueltas en esta página (opcional).
[out] Cookie
Cookie opaca, utilizada por el servidor para determinar su ubicación en el conjunto de resultados. Use ber_bvfree para liberarse.
Valor devuelto
Si la función se ejecuta correctamente, se LDAP_SUCCESS el valor devuelto.
Si la función presenta un error, devuelve un código de error. Consulte Valores devueltos para obtener más información.
Comentarios
Use ldap_parse_page_control junto con ldap_create_page_control y ldap_parse_result para implementar la paginación sencilla de los resultados mediante controles. Después de llamar a ldap_parse_page_control para recuperar los controles del servidor y extraer la cookie del resultado de la búsqueda, llame a ldap_parse_result para analizar los resultados. A continuación, use la cookie para llamar a ldap_create_page_control para recuperar la siguiente página de resultados.
Requisitos
| 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 |