ldap_parse_vlv_control(3) — Linux manual page

NAME | LIBRARY | SYNOPSIS | DESCRIPTION | SEE ALSO | ACKNOWLEDGEMENTS | COLOPHON

LDAP_PAR..._CONTROL(3)  Library Functions Manual  LDAP_PAR..._CONTROL(3)

NAME         top

       ldap_parse_vlv_control - Decode the information returned from a
       search operation that used a VLV (virtual list view) control

LIBRARY         top

       OpenLDAP LDAP (libldap, -lldap)

SYNOPSIS         top

       #include <ldap.h>

       int ldap_parse_vlv_control( ld, ctrlp, target_posp, list_countp, contextp, errcodep )
       LDAP *ld;
       LDAPControl **ctrlp;
       unsigned long *target_posp, *list_countp;
       struct berval **contextp;
       int *errcodep;

DESCRIPTION         top

       The ldap_parse_vlv_control is used to decode the information
       returned from a search operation that used a VLV (virtual list
       view)control. It takes a null terminated array of LDAPControl
       structures, usually obtained by a call to the
       ldap_parse_resultfunction, a target_pos which points to the list
       index of the target entry. If this parameter is NULL, the target
       position is not returned. The index returned is an approximation
       of the position of the target entry. It is not guaranteed to be
       exact. The parameter list_countp points to the server's estimate
       of the size of the list. If this parameter is NULL, the size is
       not returned. contextp is a pointer to the address of a berval
       structure that contains a server-generated context identifier if
       server returns one. If server does not return a context
       identifier, the server returns a NULL in this parameter. If this
       parameter is set to NULL, the context identifier is not returned.
       You should use this returned context in the next call to create a
       VLV control. When the berval structure is no longer needed, you
       should free the memory by calling the ber_bvfree function.e
       errcodep is an output parameter, which points to the result code
       returned by the server. If this parameter is NULL, the result
       code is not returned.

       See ldap.h for a list of possible return codes.

SEE ALSO         top

       ldap_search(3)

ACKNOWLEDGEMENTS         top

       OpenLDAP Software is developed and maintained by The OpenLDAP
       Project <http://www.openldap.org/>.  OpenLDAP Software is derived
       from the University of Michigan LDAP 3.3 Release.

COLOPHON         top

       This page is part of the OpenLDAP (an open source implementation
       of the Lightweight Directory Access Protocol) project.
       Information about the project can be found at 
       ⟨http://www.openldap.org/⟩.  If you have a bug report for this
       manual page, see ⟨http://www.openldap.org/its/⟩.  This page was
       obtained from the project's upstream Git repository
       ⟨https://git.openldap.org/openldap/openldap.git⟩ on 2024-06-14.
       (At that time, the date of the most recent commit that was found
       in the repository was 2024-06-13.)  If you discover any rendering
       problems in this HTML version of the page, or you believe there
       is a better or more up-to-date source for the page, or you have
       corrections or improvements to the information in this COLOPHON
       (which is not part of the original manual page), send a mail to
       [email protected]

OpenLDAP LDVERSION             RELEASEDATE        LDAP_PAR..._CONTROL(3)