Netscape NETSCAPE DIRECTORY SERVER 6.2 - GATEWAY CUSTOMIZATION, Manual

Page: 466 / 612

Functions for Managing DNs
466 Netscape Directory Server Plug-In Programmer’s Guide • December 2003
Returns
This function returns a pointer to the new
Slapi_DN
structure with a DN value set
to the content of
dn
.
Description
This function creates anew
Slapi_DN
structure and initializes its DN with the value
of
dn
. The DN of the new structure will point to the same string pointed to by
dn
(the DN value is passed in to the parameter by reference). However, the
FLAG_DN
flag is not set and no counter is incremented.
Memory Concerns
The memory is allocated by the function itself.
See Also
slapi_sdn_new_dn_byval()
slapi_sdn_new_dn_passin()
slapi_sdn_new_dn_byval()
Creates a new
Slapi_DN
structure and sets a DN value.
Syntax
#include “slapi-plugin.h”
Slapi_DN *slapi_sdn_new_dn_byval(const char *dn);
Parameters
This function takes the following parameter:
Returns
This function returns a pointer to the new
Slapi_DN
structure with a DN value set
to the content of
dn
.
dn
The DN value to be set in the new
Slapi_DN
structure.
dn
The DN value to be set in the new
Slapi_DN
structure.