42.25. slapi_value_set_string()

Description

This function sets the value of the Slapi_Value structure by duplicating the string strVal.

Syntax

#include "slapi-plugin.h"
slapi_value_set_string(Slapi_Value *value, const char *strVal);

Parameters

This function takes the following parameters:

value
Pointer to the Slapi_Value structure in which to set the value.
strVal
The string containing the value to set.
Returns

This function returns one of the following:

  • 0 if value is set.
  • -1 if the pointer to the Slapi_Value is NULL.
Memory Concerns

If the pointer to the Slapi_Value is NULL, nothing is done, and the function returns -1. If the Slapi_Value 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().