funzione ldap_create_page_control (winldap.h)

Articolo
08/27/2023

Usare la funzione ldap_create_page_control per creare un controllo di base per il paging dei risultati. Il supporto per i controlli è disponibile con LDAP 3, ma se il controllo pagina è supportato o meno dipende dal server specifico.

Sintassi

WINLDAPAPI ULONG LDAPAPI ldap_create_page_control(
  [in]  PLDAP         ExternalHandle,
  [in]  ULONG         PageSize,
  [in]  berval        *Cookie,
  [in]  UCHAR         IsCritical,
  [out] PLDAPControlA *Control
);

Parametri

[in] ExternalHandle

Handle di sessione.

[in] PageSize

Numero di voci da restituire in ogni pagina.

[in] Cookie

Puntatore a una struttura berval utilizzata dal server per determinarne la posizione nel set di risultati. Si tratta di una struttura opaca a cui non è consigliabile accedere direttamente. Impostare su NULL per la prima chiamata a ldap_create_page_control.

[in] IsCritical

Notifica al server se questo controllo è fondamentale per la ricerca.

[out] Control

Puntatore al controllo appena creato.

Valore restituito

Questa funzione restituisce WINLDAPAPI ULONG LDAPAPI.

Commenti

La funzione ldap_create_page_control crea un semplice controllo paged-results. Il controllo consente al client di specificare la frequenza con cui un server LDAP restituisce i risultati di un'operazione di ricerca. Ciò è utile quando il client dispone di risorse limitate e potrebbe non essere in grado di elaborare l'intero set di risultati da una determinata query LDAP o quando la connessione client/server è lenta.

Per creare il controllo paged-results, specificare il numero di voci da restituire in una singola pagina. Per restituire i risultati normalmente, anche se non è in grado di supportare questo controllo, impostare il parametro IsCritical su FALSE.

Questa funzione crea il controllo : non verifica che il server lo supporti e, di conseguenza, non restituisce LDAP_UNAVAILABLE_CRIT_EXTENSION se il server non supporta il controllo. Tuttavia, può restituire altri valori restituiti LDAP standard, ad esempio LDAP_NO_MEMORY o LDAP_PARAM_ERROR.

Quando ldap_create_page_control viene restituito correttamente, includere il controllo appena creato nell'elenco dei controlli server in una chiamata a ldap_search_ext o a ldap_search_ext_s. Quando il server restituisce la prima pagina dei risultati, chiamare ldap_parse_result per recuperare la prima pagina dei risultati.

Chiamare ldap_control_free quando il controllo non è più necessario.

Requisiti


Client minimo supportato	Windows Vista
Server minimo supportato	Windows Server 2008
Piattaforma di destinazione	Windows
Intestazione	winldap.h
Libreria	Wldap32.lib
DLL	Wldap32.dll