ldapNextAttribute(3ibx) — Subroutines
NAME
ldapNextAttribute − Returns the address of a character string, which contains the next attribute name from a directory entry’s attribute list.
SYNOPSIS
| #include <libldap.h> | ||
| char ∗ ldapNextAttribute( | LDAP_t ∗ldap_handle, | |
| LDAPM_t ∗directory_entry, | ||
| LDAPBE_t ∗encoding ); |
INPUT PARAMETERS
ldap_handleThe address of an LDAP handle.
directory_entryThe address of a directory entry returned by a call to either the ldapFirstEntry, or ldapNextEntry function.
OUTPUT PARAMETER
encodingThe address of the next attribute name in the entry’s attribute-value list.
DESCRIPTION
The ldapFirstAttribute function returns the address of a character string, which contains the name of the first attribute in a directory entry’s attribute list. Do not alter this character string; pass it untouched as a parameter to the ldapGetValues function to access the attribute’s value or values. If necessary, make successive calls to the ldapNextAttribute function until you have read all of the entry’s attribute names.
RETURNS
The address of a character string, which contains the entry’s next attribute name, or NULL, if the entry contains no additional attributes.
RELATED INFORMATION
Functions: ldapFirstAttribute(3), ldapFirstEntry(3), ldapGetValues(3), ldapNextEntry(3).