Netscape DIRECTORY SERVER 6.02 - PLUG-IN Manual page 298

Functions for Managing Entries
Returns
The function returns one of the following values:
•
0
function also returns
schema and has the object class
•
1
attributes, if it has any attributes not allowed by the schema (but does not have
the object class
single-valued attribute.
Memory Concerns
The
pb
SLAPI_IS_REPLACED_OPERATION
done.
slapi_entry_set_dn()
Sets the distinguished name (DN) of an entry.
Syntax
#include "slapi-plugin.h"
void slapi_entry_set_dn( Slapi_Entry *e, char *dn );
Parameters
This function takes the following parameters:
e
dn
Description
This function sets the DN pointer in the specified entry to the DN that you supply.
Note that the old DN is not overwritten and is still in memory. Because of this, you
should first call
the DN, then call
Memory Concerns
will be freed eventually when
dn
298 Netscape Directory Server Plug-In Programmer's Guide • May 2002
if the entry complies with the schema or if schema checking is turned off. The
0
if the entry is missing the
extensibleObject
argument can be
NULL
Entry to which you want to assign the DN.
Distinguished name you want assigned to the entry.
slapi_entry_get_dn()
slapi_entry_set_dn()
if the entry has additional attributes not allowed by the
extensibleObject
attribute, if it is missing any required
objectclass
), or if the entry has multiple values for a
. It is only used to get the
flag. If that flag is present, no schema checking is
to get the pointer to the current DN, free
to set the pointer to your new DN.
slapi_entry_free()
.
is called.