LDAP Library Functions                ldapgetlangvalues(3LDAP)



NAME
     ldapgetlangvalues, ldapgetlangvalueslen -  return  an
     attribute's   values  that matches a specified language sub-
     type

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

     char **ldapgetlangvalues(LDAP *ld, LDAPMessage *entry,
          const char *target, char **type


     struct berval **ldapgetlangvalueslen(LDAP *ld, LDAPMessage *entry,
          const char *target, char **type


DESCRIPTION
     The ldapgetlangvalues() function returns an array  of  an
     attribute's  string values that matches a specified language
     subtype. To retrieve the binary data from an attribute, call
     the ldapgetlangvalueslen() function instead.


     ldapgetlangvalues() should be called to retrieve a  null-
     terminated  array of an attribute's string values that match
     a specified language  subtype. The entry  parameter  is  the
     entry  retrieved  from the directory.   The target parameter
     should contain  the  attribute  type  the  values  that  are
     required,  including the optional language subtype. The type
     parameter points to a buffer that returns the attribute type
     retrieved  by   this  function. Unlike the ldapgetvalues()
     function, if a language subtype is specified, this  function
     first  attempts  to  find  and return      values that match
     that subtype, for example, cn;lang-en.


     ldapgetlangvalueslen() returns a  null-terminated  array
     of  pointers   to  berval  structures,  each  containing the
     length and pointer to a binary  value of an attribute for  a
     given  entry.  The entry parameter is the result returned by
     ldapresult()  or  ldapsearchs()  functions.  The   target
     parameter   is   the  attribute  returned  by  the  call  to
     ldapfirstattribute()  or  ldapnextattribute(),  or   the
     attribute as a  literal string, such as jpegPhoto or audio.


     These functions are  deprecated.  Use  ldapgetvalues()  or
     ldapgetvalueslen() instead.

RETURN VALUES




SunOS 5.11          Last change: 25 Oct 2001                    1






LDAP Library Functions                ldapgetlangvalues(3LDAP)



     If  successful,  ldapgetlangvalues()  returns   a   null-
     terminated  array  of the attribute's values. If the call is
     unsuccessful, or if no such attribute exists in  the  entry,
     it returns a NUL and sets the appropriate error code in the
     LDAP structure.


     The  ldapgetlangvalueslen()  function  returns  a  null-
     terminated array  of pointers to berval structures, which in
     turn, if successful, contain pointers  to  the   attribute's
     binary  values.  If  the call is unsuccessful, or if no such
     attribute exists in the entry, it returns a  NUL  and  sets
     the appropriate error code in the LDAP structure.

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



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


SEE ALSO
     ldapfirstattribute(3LDAP),    ldapfirstattribute(3LDAP),
     ldapgetvalues(3LDAP),                  ldapresult(3LDAP),
     ldapsearch(3LDAP), attributes(5)




















SunOS 5.11          Last change: 25 Oct 2001                    2