opensolaris man page for ldap_first_attribute

Query: ldap_first_attribute

OS: opensolaris

Section: 3ldap

Links: opensolaris man pages   all man pages

Forums: forum home   forum categories

Format: Original Unix Latex Style Formatted with HTML and a Horizontal Scroll Bar

ldap_first_attribute(3LDAP)				      LDAP Library Functions				       ldap_first_attribute(3LDAP)

NAME
ldap_first_attribute, ldap_next_attribute - step through LDAP entry attributes
SYNOPSIS
cc [ flag...] file... -lldap[ library...] #include <lber.h> #include <ldap.h> char *ldap_first_attribute(LDAP *ld, LDAPMessage *entry, BerElement **berptr); char *ldap_next_attribute(LDAP *ld, LDAPMessage *entry, BerElement *ber);
DESCRIPTION
The ldap_first_attribute() function gets the value of the first attribute in an entry. The ldap_first_attribute() function returns the name of the first attribute in the entry. To get the value of the first attribute, pass the attribute name to the ldap_get_values() function or to the ldap_get_values_len() function. The ldap_next_attribute() function gets the value of the next attribute in an entry. After stepping through the attributes, the application should call ber_free() to free the BerElement structure allocated by the ldap_first_attribute() function if the structure is other than NULL.
ERRORS
If an error occurs, NULL is returned and the ld_errno field in the ld parameter is set to indicate the error. See ldap_error(3LDAP) for a description of possible error codes.
ATTRIBUTES
See attributes(5) for a description of the following attributes: +-----------------------------+----------------------------------+ | ATTRIBUTE TYPE | ATTRIBUTE VALUE | +-----------------------------+----------------------------------+ |MT-Level |SUNWcsl (32-bit)SUNWcslx (64-bit) | +-----------------------------+----------------------------------+ |Interface Stability |Evolving | +-----------------------------+----------------------------------+
SEE ALSO
ldap(3LDAP), ldap_first_entry(3LDAP), ldap_get_values(3LDAP), ldap_error(3LDAP), attributes(5)
NOTES
The ldap_first_attribute() function alllocates memory that might need to be freed by the caller by means of ber_free(3LDAP). SunOS 5.11 16 Dec 2003 ldap_first_attribute(3LDAP)