Slapi_Register_Supported_Control() - Netscape DIRECTORY SERVER 7.0 - PLUG-IN Manual

Functions for Dealing with Controls
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()
calling
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 );
296 Netscape Directory Server Plug-in Programmer's Guide • October 2004
if successful.
slapi_register_supported_control()
slapi_get_supported_controls_copy()
array should be freed by calling
ctrloidsp
. The returned
.
slapi_ch_free()
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