Netscape DIRECTORY SERVER 7.0 - PLUG-IN Manual page 185

ldctl_iscritical
Description
The data type represents a client or server control associated with an
LDAPControl
LDAP operation. Controls are part of the LDAPv3 protocol. You can use a client or
server control to extend the functionality of an LDAP control.
For example, you can use a server control to specify that you want the server to sort
search results in an LDAP search operation.
The following table summarizes the front-end API functions that you can call to
work with LDAP controls.
To ...
Create an LDAPControl structure
based on a BerElement, an OID, and
a criticality flag. It returns an LDAP
error code.
Create an LDAPControl structure
based on a struct berval, an OID,
and a criticality flag. It returns an
LDAP error code.
Check for the presence of a specific
LDAPControl. It returns non-zero
for presence and zero for absence.
Retrieve the LDAPMod contained
in a Slapi_Mod structure
Register the specified control with
the server. This function associates
the control with an object
identification (OID)
Specifies whether the control is critical to the operation. This
field can have one of the following values:
• LDAP_OPT_ON specifies that the control is critical to the
operation.
• LDAP_OPT_OFF specifies that the control is not critical to
the operation.
... Call this function
slapi_build_control()
slapi_build_control_from_berval()
slapi_control_present()
slapi_mod_get_ldapmod_passout()
slapi_register_supported_control())
Chapter 14
Summary of Data Types and Structures
Data Type and Structure Reference 185