ldap_explode_dns()--Break a DNS-style Distinguished Name into Its Components

Syntax

 #include <ldap.h>
 
 char **ldap_explode_dns(
                  const char  *dn)

  Default Public Authority: *USE

  Library Name/Service Program: QSYS/QGLDCLNT

  Threadsafe: Yes

The ldap_explode_dns() function takes a Domain Name System (DNS)-style distinguished name and breaks it up into its component parts.

ldap_explode_dns() returns a NULL-terminated array of character strings.

For example, the DNS-style distinguished name rochester.ibm.com would be returned as an array of components "rochester","ibm","com",NULL. The result can be freed by calling ldap_value_free().

Authorities and Locks

No IBM^® i authority is required.

Parameters

dn: (Input) Specifies the DNS-style DN to be exploded.

Return Value

An array of character strings.: if the request was successful.
NULL: if the request was not successful.

Error Conditions

If ldap_explode_dns() is not successful, no memory is available for the array or its components.

Error Messages

The following message may be sent from this function.

Message ID	Error Message Text
CPF3CF2 E	Error(s) occurred during running of ldap_explode_dns API.

Related Information

ldap_explode_dn() -- Break a Distinguished Name into its components.
ldap_explode_dn_utf8() -- Break a UTF8 codepage Distinguished Name into Its Components
ldap_explode_rdn() -- Break a Relative Distinguished Name into its components.
ldap_explode_rdn_utf8() -- Break a UTF8 codepage Relative Distinguished Name into Its Components

API introduced: V5R1

[ Back to top | LDAP APIs | APIs by category ]