Netscape DIRECTORY SERVER 6.02 - PLUG-IN Manual page 294

Functions for Managing Entries
Syntax
#include "slapi-plugin.h"
void slapi_entry_init(Slapi_Entry *e, char *dn,
Slapi_Attr *a);
Parameters
This function takes the following parameters:
e
dn
a
Description
This function initializes the attributes and the corresponding attribute values of an
entry. Also, during the course of processing, the unique ID of the entry is set to
NULL
Use this function to initialize a
Memory Concerns
This function should always be used after
otherwise. For example:
Slapi_Entry *e = slapi_entry_alloc();
slapi_entry_init(e, NULL, NULL);
To set the DN in the entry:
slapi_sdn_set_dn_passin(slapi_entry_get_sdn(e), dn);
In this case, the dn argument is not copied, but is consumed by the function. To
copy the argument, see the following example:
char *dn = slapi_ch_strdup(some_dn);
Slapi_Entry *e = slapi_entry_alloc()
slapi_entry_init(e, dn, NULL);l
is not freed in this context, but will eventually be freed when
dn
slapi_entry_free()
294 Netscape Directory Server Plug-In Programmer's Guide • May 2002
The entry you want to initialize.
The DN of the entry you are initializing.
Initialization list of attribute value pairs, supplied as a
Slapi_Attr data value.
and the flag value is set to
is called.
.
0
pointer.
Slapi_Entry
slapi_entry_alloc()
, and never