Netscape NETSCAPE DIRECTORY SERVER 6.2 - GATEWAY CUSTOMIZATION, Manual

Page: 225 / 612

Functions for Internal Operations and Plug-In Callback
Chapter 15 Function Reference 225
Returns
This function returns one of the following values:
• 0 if successful.
• -1 if an error occurs. If -1 is returned, the
SLAPI_PLUGIN_INTOP_RESULT
field of
the parameter block should be consulted to determine the precise LDAP result
code.
Description
The function performs an internal add operation based on a parameter block. The
parameter block should be initialized by calling
slapi_add_internal_set_pb()
or
slapi_add_entry_internal_set_pb()
.
Memory Concerns
None of the parameters that are passed
slapi_add_internal_set_pb()
are
altered or consumed by this function. The entry parameter that is passed to
slapi_add_entry_internal_set_pb()
is consumed by a successful call to this
function.
slapi_delete_internal_pb()
Performs an LDAP delete operation based on a parameter block to remove a
directory entry.
Syntax
#include “slapi-plugin.h”
int slapi_delete_internal_pb(Slapi_PBlock *pb);
Parameters
This function takes the following parameter:
pb
A parameter block that has been initialized using
slapi_add_internal_set_pb()
.
pb
A parameter block that has been initialized using
slapi_delete_internal_set_pb()
.