ldap_parse_vlv_control(3) [osx man page]
LDAP_PARSE_VLV_CONTROL(3) Library Functions Manual LDAP_PARSE_VLV_CONTROL(3) NAME
ldap_parse_vlv_control - Decode the information returned from a search operation that used a VLV (virtual list view) control LIBRARY
OpenLDAP LDAP (libldap, -lldap) SYNOPSIS
#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
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 esti- mate 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 struc- ture 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
ldap_search(3) ACKNOWLEDGEMENTS
OpenLDAP Software is developed and maintained by The OpenLDAP Project <http://www.openldap.org/>. OpenLDAP Software is derived from Uni- versity of Michigan LDAP 3.3 Release. OpenLDAP 2.4.28 2011/11/24 LDAP_PARSE_VLV_CONTROL(3)
Check Out this Related Man Page
LDAP_EXTENDED_OPERATION(3) Library Functions Manual LDAP_EXTENDED_OPERATION(3) NAME
ldap_extended_operation, ldap_extended_operation_s - Extends the LDAP operations to the LDAP server. LIBRARY
OpenLDAP LDAP (libldap, -lldap) SYNOPSIS
#include <ldap.h> int ldap_extended_operation( LDAP *ld, const char *requestoid, const struct berval *requestdata, LDAPControl **sctrls, LDAPControl **cctrls, int *msgidp ); int ldap_extended_operation_s( LDAP *ld, const char *requestoid, const struct berval *requestdata, LDAPControl **sctrls, LDAPControl **cctrls, char **retoidp, struct berval **retdatap ); DESCRIPTION
The ldap_extended_operation_s() routine is used to synchronously perform an LDAP extended operation. It takes requestoid, which points to a dotted-decimal OID string identifying the extended operation to perform. requestdata is the data required for the request, sctrls is an array of LDAPControl structures to use with this extended operation, cctrls is an array of LDAPControl structures that list the client con- trols to use with this extended operation. The output parameter retoidp points to a dotted-decimal OID string returned by the LDAP server. The memory used by the string should be freed with the ldap_memfree(3) function. The output parameter retdatap points to a pointer to a berval structure that contains the returned data. If no data is returned by the server, the pointer is set this to NULL. The memory used by this structure should be freed with the ber_bvfree(3) function. The ldap_extended_operation() works just like ldap_extended_operation_s(), but the operation is asynchronous. It provides the message id of the request it initiated in the integer pointed to be msgidp. The result of this operation can be obtained by calling ldap_result(3). SEE ALSO
ber_bvfree(3), ldap_memfree(3), ldap_parse_extended_result(3), ldap_result(3) ACKNOWLEDGEMENTS
OpenLDAP Software is developed and maintained by The OpenLDAP Project <http://www.openldap.org/>. OpenLDAP Software is derived from Uni- versity of Michigan LDAP 3.3 Release. OpenLDAP 2.4.28 2011/11/24 LDAP_EXTENDED_OPERATION(3)