ldapFirstAttribute(3ibx) — Subroutines
NAME
ldapFirstAttribute − Returns the address of a character string that contains the the first attribute’s name from a directory entry’s attribute list.
SYNOPSIS
| #include <libldap.h> | ||
| char ∗ ldapFirstAttribute( | 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 an array of pointers to attribute names.
DESCRIPTION
The ldapFirstAttribute function returns the address of a character string that 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 first attribute name, or NULL, if the entry contains no attributes.
RELATED INFORMATION
Functions: ldapFirstEntry(3), ldapGetValues(3), ldapNextAttribute(3), ldapNextEntry(3).