Netscape NETSCAPE DIRECTORY SERVER 6.2 - GATEWAY CUSTOMIZATION, Manual

Page: 424 / 612

Functions for Managing Parameter Block
424 Netscape Directory Server Plug-In Programmer’s Guide • December 2003
See Also
slapi_pblock_destroy()
slapi_pblock_set()
slapi_pblock_new()
Creates a new parameter block.
Syntax
#include “slapi-plugin.h”
Slapi_PBlock *slapi_pblock_new();
Returns
This function returns a pointer to the new parameter block.
Memory Concerns
The
pblock
pointer allocated with this function must always be freed by
slapi_pblock_destroy()
. The use of other memory deallocators (for example,
free()
) is not supported and may lead to crashes or memory leaks.
slapi_pblock_set()
Sets the value of a name-value pair in a parameter block.
Syntax
#include “slapi-plugin.h”
int slapi_pblock_set( Slapi_PBlock *pb, int arg, void *value );
Parameters
This function takes the following parameters:
Returns
This function returns one of the following values:
pb
Parameter block.
arg
ID of the name-value pair that you want to set. For a list of IDs that you
can specify, see Chapter 16, “Parameter Block Reference.”
value
Pointer to the value that you want to set in the parameter block.