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 ]