slapi_entry_add_rdn_values()

Adds the components in an entry’s relative distinguished name (RDN) to the entry as attribute values. (For example, if the entry’s RDN is uid=bjensen, the function adds uid=bjensen to the entry as an attribute value.)

Syntax

#include "slapi-plugin.h"
 int slapi_entry_add_rdn_values( Slapi_Entry *e );

Parameters

This function takes the following parameter:

e

Entry to which you want to add the RDN attributes.

Returns

This function returns one of the following values:

• LDAP_SUCCESS if the values were successfully added to the entry. The function also returns LDAP_SUCCESS if the entry is NULL, if the entry’s DN is NULL, or if the entry’s RDN is NULL.

• LDAP_INVALID_DN_SYNTAX if the DN of the entry cannot be parsed.

Description

If the attribute type corresponding to the RDN already has a value matching the RDN value for equality, the value is not added. This function does not however examine other attrbute types not in the RDN, whose values may match the RDN value for equality.

Memory Concerns

Free the entry from memory by using slapi_entry_free() if the entry was allocated by the user.

See Also

slapi_entry_free()