39.23. slapi_sdn_new_dn_byref()

Description

This function creates a new 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.

Syntax

#include "slapi-plugin.h"
Slapi_DN *slapi_sdn_new_dn_byref(const char *dn);

Parameters

This function takes the following parameter:

dn
The 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 DN valueset to the content of dn.

Memory Concerns

The memory is allocated by the function itself.