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
       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 the University of Michigan LDAP 3.3 Release.