opensolaris man page for ldap_first_attribute

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)