Netscape DIRECTORY SERVER 6.02 - PLUG-IN Manual page 290

Functions for Managing Entries
Returns
This function returns the DN of the entry. Note that this returns a pointer to the
actual DN in the entry, not a copy of the DN. You should not free the DN unless
you plan to replace it by calling
Memory Concerns
Use
slapi_ch_free()
See Also
slapi_ch_free()
slapi_entry_set_dn()
slapi_entry_get_dn_const()
Returns as a
Syntax
#include "slapi-plugin.h"
const char *slapi_entry_get_dn_const(
const Slapi_Entry *e );
Parameters
This function takes the following parameter:
e
Returns
This function returns one of the following values:
• The
able to modify the
• The
Memory Concerns
Never free this value.
290 Netscape Directory Server Plug-In Programmer's Guide • May 2002
if you are replacing the DN with
the value of the entry that you specify.
const DN
Entry from which you want to get the DN as a constant.
of the entry that you specify. The
DN
value.
DN
value of
NDN Slapi_DN
slapi_entry_set_dn()
is returned as a
DN
if the of the
DN Slapi_DN
.
slapi_entry_set_dn()
; you are not
const
object is .
NULL
.