ldapExplodeDN(3ibx) — Subroutines
NAME
ldapExplodeDN − Returns a pointer to a character string containing the relative distinguished name of the directory entry.
SYNOPSIS
| #include <libldap.h> | ||
| char ∗∗ ldapExplodeDN( | char ∗distinguished_name, | |
| int no_entry ); |
INPUT PARAMETERS
distinguished_nameThe address of a character string containing the directory entry’s distinguished name, which was returned by a call to the ldapGetDN function. The following is an example of an LDAP-compliant distinguished name:
(cn="Joan Smith", ou=marketing, o="Big Corporation", c=us)
no_entryAn unused parameter; pass any integer.
DESCRIPTION
When you are finished using the ldapExplodeDN function, you need to free the memory used to store the relative distinguished name. (C users can call the free function.)
RETURNS
A pointer that points to the character string containing the relative distinguished name (which is embedded in the distinguished name), or NULL, if the function encountered an error.
RELATED INFORMATION
Functions: ldapGetDN(3).