24.6. slapi_entry_add_values_sv()

Description

This function adds an array of Slapi_Value data values to an attribute. If the attribute does not exist, it is created and given the value contained in the Slapi_Value array.

This function replaces the deprecated slapi_entry_add_values() function. This function uses Slapi_Value attribute values instead of the now obsolete berval attribute values.
Syntax

#include "slapi-plugin.h"
int slapi_entry_add_values_sv( Slapi_Entry *e, const char *type, Slapi_Value **vals );

Parameters

This function takes the following parameters:

e
Entry to which you want to add values.
type
Attribute type to which you want to add values.
vals
Array of Slapi_Value data values that you want to add.
Returns

This function returns one of the following values:

  • LDAP_SUCCESS if the Slapi_Value array is successfully added to the attribute.
  • LDAP_TYPE_OR_VALUE_EXISTS if any values you are trying to add duplicate an existing value in the attribute.
  • LDAP_OPERATIONS_ERROR if there are pre-existing duplicate values in the attribute.
Memory Concerns

This routine makes a copy of the parameter vals. vals can be NULL.