função ldap_get_next_page (winldap.h)
A função ldap_get_next_page retorna a próxima página em uma sequência de resultados de pesquisa de páginas assíncronas.
Sintaxe
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 sessão.
[in] SearchHandle
Identificador de bloco de pesquisa.
[in] PageSize
O número de entradas a serem retornadas em uma única página.
[out] MessageNumber
A ID da mensagem para a solicitação.
Retornar valor
Se a função for bem-sucedida, o valor retornado será LDAP_SUCCESS.
Se a função falhar, ela retornará um valor retornado do código de erro. Para obter mais informações, consulte Valores retornados.
Comentários
A função ldap_get_next_page faz parte da interface para paginação simples e assíncrona dos resultados da pesquisa. Use o identificador de pesquisa retornado de uma chamada inicial para ldap_search_init_page e especifique, no parâmetro PageSize , o número de entradas a serem retornadas em uma página. Defina PageSize como zero para abandonar uma pesquisa.
Lembre-se de que, após cada chamada para ldap_get_next_page, você deve chamar ldap_get_paged_count para cada conjunto de resultados retornados do servidor usando ldap_result. Isso permite que o tempo de execução LDAP salve o cookie que o servidor passou de volta para manter o estado de pesquisa. Além de chamar ldap_get_paged_count, os resultados retornados de ldap_get_next_page podem ser tratados como qualquer outro resultado de pesquisa e devem ser liberados quando concluídos chamando ldap_msgfree.
Ao analisar o conjunto de resultados, lembre-se de que é possível que o servidor retorne uma página vazia de resultados e ainda responda com um valor retornado LDAP_SUCCESS . Isso indica que o servidor não pôde recuperar uma página de resultados devido a um tempo limite ou outro motivo, mas não concluiu a solicitação de pesquisa. O comportamento adequado, nesta instância, é continuar a chamar ldap_get_next_page até que outra página de resultados seja recuperada com êxito, um código de erro seja retornado ou LDAP_NO_RESULTS_RETURNED seja retornado para indicar que a pesquisa está concluída.
Se preferir recuperar resultados de pesquisa paginado de forma síncrona, use ldap_get_next_page_s.
Requisitos
| Requisito | Valor |
|---|---|
| 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 |