Netscape DIRECTORY SERVER 6.02 - PLUG-IN Manual page 241

Syntax
#include "slapi-plugin.h"
int slapi_build_control_from_berval( char *oid,
struct berval *bvp,char iscritical, LDAPControl **ctrlp );
Parameters
This function takes the following parameters:
oid
bvp
iscritical
ctrlp
Returns
This function returns
Description
This function creates an
OID, and a criticality flag. The
client requests or internal operations.
Memory Concerns
The contents of the
bvp
the caller should not free the
function has been made.
The pointer that is returned in
LDAPControl
ldap_control_free()
SDK for C Programmer's Guide).
See Also
slapi_build_control()
slapi_dup_control()
ldap_control_free()
The OID (object identifier) for the control that is to be created.
A struct berval that contains the control value. Pass NULL if
the control has no value.
The criticality flag. If non-zero, the control will be marked as
critical. If 0, it will not be marked as critical.
Pointer that will receive the allocated LDAPControl structure.
(LDAP result code) if successful.
LDAP_SUCCESS
structure based on a
LDAPControl
LDAPControl
parameter are consumed by this function. Because of this,
bvp->bv_val
, which is an LDAP API function (see the Netscape LDAP
Functions for Dealing with Controls
struct berval
that is created can be used in LDAP
pointer once a successful call to this
should be freed by calling
ctrlp
Chapter 14
, an
Function Reference 241