Netscape DIRECTORY SERVER 6.2 - PLUG-IN Manual page 286

Functions for Dealing with Controls
Returns
This function returns one of the following values:
• 0 if successful.
• 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()
See Also
slapi_register_supported_control()
slapi_ch_array_free()
slapi_register_supported_control()
Registers the specified control with the server. This function associates the control
with an object identification (OID). When the server receives a request that
specifies this OID, the server makes use of this information to determine if the
control is supported by the server or its plug-ins.
Syntax
#include "slapi-plugin.h"
void slapi_register_supported_control( char *controloid,
unsigned long controlops );
286 Netscape Directory Server Plug-In Programmer's Guide • December 2003
slapi_register_supported_control()
slapi_get_supported_controls_copy()
ctrloidsp
ctrlopsp
array should be freed by calling
ctrloidsp
. The returned
.
slapi_get_supported_controls()
to register a control, you
array, the corresponding array element
array identifies the operations that support
.
array should be freed by calling
ctrlopsp
.