Show Table of Contents
21.3. slapi_build_control()
This function creates an LDAPControl structure based on a BerElement, an OID, and a criticality flag. The LDAPControl that is created can be used in LDAP client requests or internal operations.
Syntax
#include "slapi-plugin.h" int slapi_build_control( char *oid, BerElement *ber, char iscritical, LDAPControl **ctrlp );
Parameters
This function takes the following parameters:
|
oid
| The OID (object identifier) for the control that is to be created. |
|
ber
| A BerElement that contains the control value. Pass NULL if the control has no value. |
|
iscritical
| The criticality flag. If non-zero, the control will be marked as critical. If 0, it will not be marked as critical. |
|
ctrlp
| Pointer that will receive the allocated LDAPControl structure. |
Returns
This function returns LDAP_SUCCESS (LDAP result code) if successful.
Memory Concerns
The contents of the ber parameter are consumed by this function. Because of this, the caller should not free the BerElement once a successful call has been made to slapi_build_control().
The LDAPControl pointer that is returned in ctrlp should be freed by calling
ldap_control_free(), which is an LDAP API function; see the Mozilla LDAP SDK for C Programmer's Guide.
Where did the comment section go?
Red Hat's documentation publication system recently went through an upgrade to enable speedier, more mobile-friendly content. We decided to re-evaluate our commenting platform to ensure that it meets your expectations and serves as an optimal feedback mechanism. During this redesign, we invite your input on providing feedback on Red Hat documentation via the discussion platform.