Netscape NETSCAPE DIRECTORY SERVER 6.2 - GATEWAY CUSTOMIZATION, Manual

Page: 509 / 612

Functions for Handling Values
Chapter 15 Function Reference 509
slapi_value_set()
Sets the value in a
Slapi_Value
structure.
Syntax
#include “slapi-plugin.h”
slapi_value_set( Slapi_Value *value, void *val, unsigned long len);
Parameters
This function takes the following parameters:
Returns
This function returns a pointer to the
Slapi_Value
with the value set.
Description
This function sets the value in the
Slapi_Value
structure. The value is a duplicate
of the data pointed to by
val
and of length
len
.
Memory Concerns
If the pointer to the
Slapi_Value
structure is
NULL
, then nothing is done and the
function returns
NULL
. If the
Slapi_Value
structure already contains a value, it is
freed from memory before the new one is set.
When you are no longer using the
Slapi_Value
structure, you should free it from
memory by calling
slapi_value_free()
.
See Also
slapi_value_free()
slapi_value_set_berval()
Copies the value from a
berval
structure into a
Slapi_Value
structure.
value
Pointer to the
Slapi_Value
in which to set the value.
val
Pointer to the value.
len
Length of the value.