1LDAP_EXTENDED_OPERATION(3) Library Functions Manual LDAP_EXTENDED_OPERATION(3)
2
3
4

NAME

6       ldap_extended_operation,  ldap_extended_operation_s  - Extends the LDAP
7       operations to the LDAP server.
8

LIBRARY

10       OpenLDAP LDAP (libldap, -lldap)
11

SYNOPSIS

13       #include <ldap.h>
14
15       int ldap_extended_operation(
16              LDAP *ld,
17              const char *requestoid,
18              const struct berval *requestdata,
19              LDAPControl **sctrls,
20              LDAPControl **cctrls,
21              int *msgidp );
22
23       int ldap_extended_operation_s(
24              LDAP *ld,
25              const char *requestoid,
26              const struct berval *requestdata,
27              LDAPControl **sctrls,
28              LDAPControl **cctrls,
29              char **retoidp,
30              struct berval **retdatap );
31

DESCRIPTION

33       The ldap_extended_operation_s() routine is used to  synchronously  per‐
34       form  an LDAP extended operation.  It takes requestoid, which points to
35       a dotted-decimal OID string identifying the extended operation to  per‐
36       form.  requestdata  is  the data required for the request, sctrls is an
37       array of LDAPControl structures to use with  this  extended  operation,
38       cctrls  is an array of LDAPControl structures that list the client con‐
39       trols to use with this extended operation.
40
41       The output parameter retoidp points to a dotted-decimal OID string  re‐
42       turned  by  the  LDAP  server.  The memory used by the string should be
43       freed with the ldap_memfree(3) function.  The output parameter retdatap
44       points  to  a  pointer to a berval structure that contains the returned
45       data.  If no data is returned by the server, the pointer is set this to
46       NULL.   The  memory  used  by  this  structure should be freed with the
47       ber_bvfree(3) function.
48
49       The  ldap_extended_operation()  works  just  like  ldap_extended_opera‐
50       tion_s(),  but  the operation is asynchronous.  It provides the message
51       id of the request it initiated in the integer  pointed  to  be  msgidp.
52       The result of this operation can be obtained by calling ldap_result(3).
53

SEE ALSO

55       ber_bvfree(3), ldap_memfree(3), ldap_parse_extended_result(3), ldap_re‐
56       sult(3)
57

ACKNOWLEDGEMENTS

59       OpenLDAP Software is developed and maintained by The  OpenLDAP  Project
60       <http://www.openldap.org/>.  OpenLDAP Software is derived from the Uni‐
61       versity of Michigan LDAP 3.3 Release.
62
63
64
65OpenLDAP                          2021/06/03        LDAP_EXTENDED_OPERATION(3)
Impressum