39.26. slapi_sdn_new_ndn_byref()

Description

This function creates a new Slapi_DN structure and initializes its normalized DN with the value of ndn. The normalized DN of the new structure will point to the same string pointed to by ndn; the normalized DN value is passed into the parameter by reference. However, the FLAG_NDN flag is not set, and no counter is incremented.

Syntax

#include "slapi-plugin.h"
Slapi_DN *slapi_sdn_new_ndn_byref(const char *ndn);

Parameters

This function takes the following parameter:

ndn
The normalized DN value to be set in the new Slapi_DN structure.
Returns

This function returns a pointer to the new Slapi_DN structure with a normalized DN valueset to the content of ndn.

Memory Concerns

The memory is allocated by the function itself.