Functions For Registering Object Extensions; Slapi_Get_Object_Extension() - Netscape DIRECTORY SERVER 7.0 - PLUG-IN Manual

Functions for Registering Object Extensions

This section contains reference information on routines for registering object
extensions. This set of functions provides a means for extending core server objects;
this functionality is provided so that you can efficiently pass state information
between plug-in calls. Typically, a plug-in might register both a pre-operation and
post-operation call. It is very convenient for the plug-in to associate its private data
with the operation object that is passed through the parameter block.
Table 15-34 Routines for Registering Object Extensions
Function

slapi_get_object_extension()

slapi_register_object_extension()
slapi_set_object_extension()
slapi_get_object_extension()
Retrieves a pointer to the plug-in extension.
Syntax
#include "slapi-plugin.h"
void *slapi_get_object_extension(int objecttype, void *object,
int extensionhandle);
Parameters
This function takes the following parameters:
objecttype
object
extensionhandle
Returns
This function returns a pointer to the plug-in's extension.
Description
Retrieves a pointer to the plug-in extension.
Registers a plug-in's object extension.
Changes a plug-in's object extension.
The object type handle that was returned from the
slapi_register_object_extension() call.
A pointer to the core server object from which the extension is to
be retrieved.
The extension handle that was returned from the
slapi_register_object_extension() call.
Functions for Registering Object Extensions
Chapter 15 Function Reference 555