Netscape DIRECTORY SERVER 6.2 - PLUG-IN Manual page 547

constructor
destructor
objecttype
extensionhandle
Description
When a plug-in is initialized, it must register its object extensions. It must provide
the name of the object to be extended, say "Operation," and constructor and
destructor functions. These functions are called when the object is constructed and
destroyed. The extension functions must allocate some memory and initialize it for
its own use. The registration function will fail if any objects have already been
created; this is why the registration must happen during plug-in initialization. In
return, the plug-in will receive two handles, one for the object type and another one
for the object extension; these only have meaning for the
slapi_get_object_extension()
Returns
This function returns 0 if successful, error code otherwise.
See Also
slapi_get_object_extension()
slapi_set_object_extension()
slapi_set_object_extension()
Changes a plug-in's object extension.
Syntax
#include "slapi-plugin.h"
void slapi_set_object_extension(int objecttype, void *object,
int extensionhandle, void *extension);
The function provided by the plug-in which is to be called when
an instance of the core server object is created. This function
must allocate some memory and return a pointer to be stored in
the extension block on the object.
The function which is called when an instance of an object is
destroyed. This function must release any resources acquired by
the constructor function.
Handle to find the offset into the object where the extension
block is stored.
Address, which is used to find the extension within the block.
function.
Functions for Registering Object Extensions
Chapter 15 Function Reference 547