LDAP Library Functions             ldapgetentrycontrols(3LDAP)



NAME
     ldapgetentrycontrols - get  the  LDAP  controls  included
     with a directory entry in a set of search results

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

     int ldapgetentrycontrols(LDAP *ld, LDAPMessage *entry,
          LDAPControl ***serverctrlsp


DESCRIPTION
     The ldapgetentrycontrols() function retrieves the LDAP v3
     controls  included in a directory entry in a chain of search
     results. The LDAP controls are  specified  in  an  array  of
     LDAPControl    structures.    Each   LDAPControl   structure
     represents an LDAP control. The function takes  entry  as  a
     parameter,  which  points  to  an LDAPMessage structure that
     represents an entry in a chain of search results.


     The entry notification controls  that  are  used  with  per-
     sistent  search  controls  are  the  only  controls that are
     returned  with  individual  entries.  Other   controls   are
     returned  with  results  sent  from the server. You can call
     ldapparseresult() to retrieve those controls.

ERORS
     ldapgetentrycontrols() returns the following error codes.

     LDAPSUCES           LDAP   controls   were   successfully
                            retrieved.


     LDAPDECODINGEROR    An error occurred when  decoding  the
                            BER-encoded message.


     LDAPARAMEROR       An invalid parameter  was  passed  to
                            the function.


     LDAPNOMEMORY         Memory cannot be allocated.


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






SunOS 5.11           Last change: 6 Jan 2003                    1






LDAP Library Functions             ldapgetentrycontrols(3LDAP)



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


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










































SunOS 5.11           Last change: 6 Jan 2003                    2