Table of Contents | Previous | Next | Index

Netscape Directory SDK 3.0 for C Programmer’s Guide
Chapter 18 Functions

ldap_explode_dn()

The ldap_explode_dn() function converts a distinguished name (DN) into its component parts. For more information, see "Getting the Components of a Distinguished Name" on page 129.

Syntax

#include <ldap.h>
char ** ldap_explode_dn( const char *dn, int notypes );

Parameters

This function has the following parameters:

dn
Distinguished name (DN) that you want separated into components.

notypes
Specifies whether or not type names in the distinguished name are returned. This parameter can have the following possible values:
0 specifies that type names are returned.
A non-zero value specifies that type names are not returned.

Returns

One of the following values:

If successful, returns a NULL-terminated array containing the components of the distinguished name (DN).

If unsuccessful, returns a NULL.

Example

The following function call:

ldap_explode_dn( "uid=bjensen, ou=People, o=Airius.com", 0 )

returns this array:

{ "uid=bjensen", "ou=People", "ou=Airius.com", NULL }

If you change the notypes parameter from 0 to 1:

ldap_explode_dn( "uid=bjensen, ou=People, o=Airius.com", 1 )

the component names are not returned in the array:

{ "bjensen", "People", "Airius.com", NULL }

See Also

ldap_explode_rdn(), ldap_get_dn().

Table of Contents | Previous | Next | Index

Last Updated: 10/01/98 17:06:23