LDAP Library Functions                ldapfirstattribute(3LDAP)



NAME
     ldapfirstattribute,  ldapnextattribute  -  step  through
     LDAP entry attributes

SYNOPSIS
     cc [ flag...] file... -lldap[ library...]
     #include 
     #include 

     char *ldapfirstattribute(LDAP *ld, LDAPMessage *entry,
          BerElement **berptr);


     char *ldapnextattribute(LDAP *ld, LDAPMessage *entry,
          BerElement *ber);


DESCRIPTION
     The ldapfirstattribute() function gets the  value  of  the
     first attribute in an entry.


     The ldapfirstattribute() 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  ldapgetvalues()
     function or to the ldapgetvalueslen() function.


     The ldapnextattribute() function gets  the  value  of  the
     next attribute in an entry.


     After  stepping  through  the  attributes,  the  application
     should  call  berfree()  to  free  the BerElement structure
     allocated by  the  ldapfirstattribute()  function  if  the
     structure is other than NUL.

ERORS
     If an error occurs, NUL is returned and the lderrno  field
     in  the  ld  parameter  is  set  to  indicate the error. See
     ldaperror(3LDAP) for a description of possible error codes.

ATRIBUTES
     See attributes(5) for a description of the following  attri-
     butes:










SunOS 5.11          Last change: 16 Dec 2003                    1






LDAP Library Functions                ldapfirstattribute(3LDAP)



     
           ATRIBUTE TYPE                  ATRIBUTE VALUE         
    
     MT-Level                     SUNWcsl (32-bit)SUNWcslx (64-bit)
    
     Interface Stability          Evolving                         
    


SEE ALSO
     ldap(3LDAP),                        ldapfirstentry(3LDAP),
     ldapgetvalues(3LDAP), ldaperror(3LDAP), attributes(5)

NOTES
     The ldapfirstattribute() function alllocates  memory  that
     might   need   to  be  freed  by  the  caller  by  means  of
     berfree(3LDAP).






































SunOS 5.11          Last change: 16 Dec 2003                    2