This manual page is for Mac OS X version 10.6.3

Reading manual pages

LDAP_EXTENDED_OPERATION(3)                                                        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 controls 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 asyn-chronous. asynchronous.
       chronous.   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 University of Michigan LDAP 3.3 Release.



OpenLDAP 2.4.11                                  2008/07/16                       LDAP_EXTENDED_OPERATION(3)