21.5. slapi_control_present()

Description

Determines whether the specified object identification (OID) identifies a control that is present in a list of controls.

Syntax

#include "slapi-plugin.h"
int slapi_control_present( LDAPControl **controls, char *oid, struct berval **val, int *iscritical );

Parameters

This function takes the following parameters:

controls
List of controls that you want to check.
oid
OID of the control that you want to find.
val
If the control is present in the list of controls, specifies the pointer to the berval structure containing the value of the control.
iscritical
If the control is present in the list of controls, specifies whether the control is critical to the operation of the server:
  • 0 means that the control is not critical to the operation.
  • 1 means that the control is critical to the operation.
Returns

This function returns one of the following values:

  • 1 if the specified control is present in the list of controls.
  • 0 if the control is not present in the list of controls.
Memory Concerns

The val output parameter is set to point into the controls array. A copy of the control value is not made.