função ldap_parse_page_control (winldap.h)
O ldap_parse_page_control analisa os resultados de uma pesquisa em páginas.
Sintaxe
WINLDAPAPI ULONG LDAPAPI ldap_parse_page_control(
[in] PLDAP ExternalHandle,
[in] PLDAPControlA *ServerControls,
[out] ULONG *TotalCount,
[out] berval **Cookie
);
Parâmetros
[in] ExternalHandle
O identificador de sessão.
[in] ServerControls
Uma matriz de controles que inclui um controle de página. O controle de página contém os campos cookie e contagem total retornados pelo servidor.
[out] TotalCount
Um ponteiro para a contagem total de entradas retornadas nesta página (opcional).
[out] Cookie
Um cookie opaco, usado pelo servidor para determinar sua localização no conjunto de resultados. Use ber_bvfree para liberar.
Valor retornado
Se a função for bem-sucedida, o valor retornado será LDAP_SUCCESS.
Se a função falhar, será exibido um código de erro. Consulte Valores retornados para obter mais informações.
Comentários
Use ldap_parse_page_control em conjunto com ldap_create_page_control e ldap_parse_result para implementar a paginação simples de resultados por meio de controles. Depois de chamar ldap_parse_page_control para recuperar os controles do servidor e extrair o cookie do resultado da pesquisa, chame ldap_parse_result para analisar os resultados. Em seguida, use o cookie para chamar ldap_create_page_control para recuperar a próxima página de resultados.
Requisitos
| Cliente mínimo com suporte | Windows Vista |
| Servidor mínimo com suporte | Windows Server 2008 |
| Plataforma de Destino | Windows |
| Cabeçalho | winldap.h |
| Biblioteca | Wldap32.lib |
| DLL | Wldap32.dll |