Netscape DIRECTORY SERVER 6.2 - PLUG-IN Manual page 175

ldctl_iscritical
Description
The data type represents a client or server control associated with an
LDAPControl
LDAP operation. Controls are part of the LDAP v3 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 do this...
Creates an LDAPControl structure
based on a BerElement, an OID, and
a criticality flag. Returns an LDAP
error code.
Creates an LDAPControl structure
based on a struct berval, an OID,
and a criticality flag. Returns an
LDAP error code.
Checks for the presence of a specific
LDAPControl. Returns non-zero
for presence and zero for absence.
Retrieves the LDAPMod contained
in a Slapi_Mod structure
Registers the specified control with
the server. This function associates
the control with an object
identification (OID)
Specifies whether or not 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 175