Sun Directory Server Enterprise Edition 7.0 Developer's Guide

LDAPControl

Represents a client or server control associated with an LDAP operation as specified by LDAP v3.

Client and server controls may be used to extend the functionality of an LDAP operation.

Syntax

/* Defined in ldap.h, which is included by slapi-plugin.h */
#include "slapi-plugin.h"
typedef struct ldapcontrol {
    char          * ldctl_oid;
    struct berval   ldctl_value;
    char            ldctl_iscritical;
} LDAPControl, * PLDAPControl;

Fields

This structure has the following fields.

Table 14–4 LDAPControl Fields

Field 

Description 

ldctl_oid

Object identifier (OID) for the control. 

ldctl_value

berval structure containing the value used by the control for the operation.

ldctl_iscritical

LDAP_OPT_ON indicates the control is critical to the operation. If the control is critical to the operation but not supported, the server returns LDAP_UNAVAILABLE_CRITICAL_EXTENSION.

LDAP_OPT_OFF indicates the control is not critical.