funzione ldap_get_next_page (winldap.h)
La funzione ldap_get_next_page restituisce la pagina successiva in una sequenza di risultati della ricerca con paging asincroni.
Sintassi
WINLDAPAPI ULONG LDAPAPI ldap_get_next_page(
[in] PLDAP ExternalHandle,
[in] PLDAPSearch SearchHandle,
[in] ULONG PageSize,
[out] ULONG *MessageNumber
);
Parametri
[in] ExternalHandle
Handle di sessione.
[in] SearchHandle
Handle di blocco di ricerca.
[in] PageSize
Numero di voci da restituire in una singola pagina.
[out] MessageNumber
ID del messaggio per la richiesta.
Valore restituito
Se la funzione ha esito positivo, il valore restituito viene LDAP_SUCCESS.
Se la funzione ha esito negativo, restituisce un valore restituito dal codice di errore. Per altre informazioni, vedere Valori restituiti.
Commenti
La funzione ldap_get_next_page fa parte dell'interfaccia per il paging semplice e asincrono dei risultati della ricerca. Usare l'handle di ricerca restituito da una chiamata iniziale a ldap_search_init_page e specificare, nel parametro PageSize , il numero di voci da restituire in una pagina. Impostare PageSize su zero per abbandonare una ricerca.
Tenere presente che dopo ogni chiamata a ldap_get_next_page, è necessario chiamare ldap_get_paged_count per ogni set di risultati restituiti dal server usando ldap_result. In questo modo il runtime LDAP consente di salvare il cookie passato dal server per mantenere lo stato di ricerca. Oltre a chiamare ldap_get_paged_count, i risultati restituiti da ldap_get_next_page possono essere gestiti come qualsiasi altro risultato della ricerca e devono essere liberati al termine chiamando ldap_msgfree.
Quando si analizza il set di risultati, tenere presente che è possibile che il server restituisca una pagina vuota di risultati e che risponda ancora con un valore restituito LDAP_SUCCESS . Ciò indica che il server non è riuscito a recuperare una pagina di risultati, a causa di un timeout o di un altro motivo, ma non ha completato la richiesta di ricerca. Il comportamento corretto, in questa istanza, consiste nel continuare a chiamare ldap_get_next_page finché non viene recuperata correttamente un'altra pagina di risultati, viene restituito un codice di errore o LDAP_NO_RESULTS_RETURNED viene restituito per indicare che la ricerca è stata completata.
Se si preferisce recuperare i risultati della ricerca con paging in modo sincrono, usare ldap_get_next_page_s.
Requisiti
Requisito | Valore |
---|---|
Client minimo supportato | Windows Vista |
Server minimo supportato | Windows Server 2008 |
Piattaforma di destinazione | Windows |
Intestazione | winldap.h |
Libreria | Wldap32.lib |
DLL | Wldap32.dll |