Red Hat DIRECTORY SERVER 7.1 - PLUG-IN PROGRAMMERS Manual page 216

Summary of Data Types and Structures
For example, when the plug-in function for an LDAP bind operation is called, the
server puts the DN and credentials in the
SLAPI_BIND_CREDENTIALS
call
slapi_pblock_get()
authentication.
For plug-in initialization functions, you can use the
pass information to the server, such as the description of your plug-in and the
names of your plug-in functions. You can set the value of a parameter by calling
the
slapi_pblock_set()
For example, in order to register a pre-operation bind plug-in function, you need
to call
the plug-in function as the
SLAPI_PLUGIN_DESCRIPTION
The available parameters that you can use depends on the type of plug-in
function you are writing.
The following table summarizes the front-end API functions that you can call to
work with block parameters.
To ...
Set up a parameter block so that it
can be used by
slapi_add_internal_pb() for
an internal add operation.
Add an LDAP add operation based
on a parameter block to add a new
directory entry.
Set up a parameter block so that it
can be used by
slapi_add_internal_pb() for
an internal add operation; the entry
is constructed from a DN and a set
of attributes.
Perform an LDAP delete operation
based on a parameter block to
remove a directory entry.
Delete an internal parameter block
set.
214 Red Hat Directory Server Plug-in Programmer's Guide • May 2005
to get the DN and credentials of the client requesting
function.
slapi_pblock_set()
SLAPI_BIND_TARGET
parameters of the
Slapi_PBlock
to set the version number, description, and name of
SLAPI_PLUGIN_VERSION
, and
SLAPI_PLUGIN_PRE_BIND_FN
... Call this function
slapi_add_entry_internal_set_pb()
slapi_add_internal_pb()
slapi_add_internal_set_pb()
slapi_delete_internal_set_pb()
slapi_delete_internal_set_pb()
and
structure. You can
structure to
Slapi_PBlock
,
parameters.