Netscape DIRECTORY SERVER 6.02 - PLUG-IN Manual page 244

Functions for Dealing with Controls
Syntax
#include "slapi-plugin.h"
int slapi_get_supported_controls_copy( char ***ctrloidsp,
unsigned long **ctrlopsp );
Parameters
This function takes the following parameters:
ctrloidsp
ctrlopsp
Returns
This function returns one of the following values:
•
0
• A non-zero value if an error occurs.
Description
This function replaces the deprecated
function from previous releases, as it was not multithread safe.
When you call
specify the OID of the control and the IDs of the operations that support the
control. The server records this information in two arrays; an array of control OIDs,
and an array of operations that support the control. You can get copies of these
arrays by calling
For each OID returned in the
(with the same index) in the
the control. For a list of the possible IDs for the operations, see
slapi_register_supported_control()
Memory Concerns
The returned
slapi_ch_array_free()
slapi_ch_free()
244 Netscape Directory Server Plug-In Programmer's Guide • May 2002
Pointer to a character array that will receive the set of supported
control OIDs. Pass NULL for this parameter if you do not wish to
receive the OIDs.
Pointer to an unsigned long array that will receive the supported
operation values for each control in the ctrloidsp array. Pass
NULL for this parameter if you do not wish to receive the
supported operation values.
if successful.
slapi_register_supported_control()
slapi_get_supported_controls_copy()
array should be freed by calling
ctrloidsp
. The returned
.
slapi_get_supported_controls()
array, the corresponding array element
ctrloidsp
array identifies the operations that support
ctrlopsp
.
ctrlopsp
to register a control, you
.
array should be freed by calling