LDAP Library Functions                  ldapfirstmessage(3LDAP)



NAME
     ldapfirstmessage, ldapcountmessages,  ldapnextmessage,
     ldapmsgtype - LDAP message processing functions

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

     int ldapcountmessages(LDAP *ld, LDAPMessage *res);


     LDAPMessage *ldapfirstmessage(LDAP *ld, LDAPMessage *res);


     LDAPMessage *ldapnextmessage(LDAP *ld, LDAPMessage *msg);


     int ldapmsgtype(LDAPMessage *res);


DESCRIPTION
     ldapcountmessages() is used to count the  number  of  mes-
     sages  that  remain  in  a chain of results if called with a
     message,     entry,     or     reference     returned     by
     ldapfirstmessage(),                   ldapnextmessage(),
     ldapfirstentry(),                       ldapnextentry(),
     ldapfirstreference(), and  ldapnextreference()


     ldapfirstmessage() and   ldapnextmessage() functions are
     used  to step through the list of messages in a result chain
     returned by  ldapresult().


     ldapmsgtype() function returns the type of an LDAP message.

RETURN VALUES
     ldapfirstmessage() and  ldapnextmessage() return   LDAP-
     Message  which can include referral messages, entry messages
     and result messages.


     ldapcountmessages() returns the number  of  messages  con-
     tained in a chain of results.

ERORS
     ldapfirstmessage() and  ldapnextmessage()  return   NUL
     when  no  more  messages exist.  NUL is also returned if an
     error occurs while  stepping through the entries,  in  which
     case  the error parameters in the session handle  ld will be
     set to indicate the error.



SunOS 5.11          Last change: 27 Jan 2002                    1






LDAP Library Functions                  ldapfirstmessage(3LDAP)



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



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


SEE ALSO
     ldaperror(3LDAP), ldapresult(3LDAP), attributes(5)







































SunOS 5.11          Last change: 27 Jan 2002                    2