Functions For Managing Parameter Block - Netscape DIRECTORY SERVER 6.1 - PLUG-IN Manual

Functions for Managing Parameter Block

This section contains reference information on parameter block routines.
Table 15-21 Parameter Block Routines
Function
slapi_pblock_destroy()
slapi_pblock_get()
slapi_pblock_new()
slapi_pblock_set()
slapi_pblock_destroy()
Frees the specified parameter block from memory.
Syntax
#include "slapi-plugin.h"
void slapi_pblock_destroy( Slapi_PBlock *pb );
Parameters
This function takes the following parameters:
pb
Memory Concerns
The parameter block that you wish to free must have been created using
slapi_pblock_new()
example,
and may lead to memory errors and memory leaks. For example:
Slapi_PBlock *pb = malloc(sizeof(Slapi_PBlock));
After calling this function, you should set the
reusing freed memory in your function context, as in the following:
slapi_pblock_destroy(pb);
pb =NULL;
Description
Frees a pblock from memory.
Gets the value from a pblock.
Creates a new pblock.
Sets the value of a pblock.
Parameter block that you want to free.
. Use of this function with
;), or using another memory allocator, is not supported
Slapi_PBlock pb
Functions for Managing Parameter Block
allocated on the stack (for
pblocks
pointer to
pblock NULL
Chapter 15 Function Reference
to avoid
421