funzione ldap_parse_page_control (winldap.h)

Il ldap_parse_page_control analizza i risultati di una ricerca in pagine.

Sintassi

WINLDAPAPI ULONG LDAPAPI ldap_parse_page_control(
  [in]  PLDAP         ExternalHandle,
  [in]  PLDAPControlA *ServerControls,
  [out] ULONG         *TotalCount,
  [out] berval        **Cookie
);

Parametri

[in] ExternalHandle

Handle di sessione.

[in] ServerControls

Matrice di controlli che include un controllo pagina. Il controllo pagina contiene i campi di conteggio totale e cookie restituiti dal server.

[out] TotalCount

Puntatore al numero totale di voci restituite in questa pagina (facoltativo).

[out] Cookie

Cookie opaco, usato dal server per determinare la posizione nel set di risultati. Usare ber_bvfree gratuitamente.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è LDAP_SUCCESS.

Se la funzione non viene completata, restituisce un codice di errore. Per altre informazioni, vedere Valori restituiti .

Commenti

Usare ldap_parse_page_control insieme a ldap_create_page_control e ldap_parse_result per implementare il paging semplice dei risultati tramite controlli. Dopo aver chiamato ldap_parse_page_control per recuperare i controlli server ed estrarre il cookie dal risultato della ricerca, chiamare ldap_parse_result per analizzare i risultati. Usare quindi il cookie per chiamare ldap_create_page_control per recuperare la pagina successiva dei risultati.

Requisiti

Vedi anche

Funzioni

ldap_create_page_control

ldap_parse_result