1ldap_first_attribute(3LDAP) LDAP Library Functions ldap_first_attribute(3LDAP)
2
3
4

NAME

6       ldap_first_attribute,  ldap_next_attribute  -  step  through LDAP entry
7       attributes
8

SYNOPSIS

10       cc [ flag...] file... -lldap[ library...]
11       #include <lber.h>
12       #include <ldap.h>
13
14       char *ldap_first_attribute(LDAP *ld, LDAPMessage *entry,
15            BerElement **berptr);
16
17
18       char *ldap_next_attribute(LDAP *ld, LDAPMessage *entry,
19            BerElement *ber);
20
21

DESCRIPTION

23       The  ldap_first_attribute()  function  gets  the  value  of  the  first
24       attribute in an entry.
25
26
27       The  ldap_first_attribute()  function  returns  the  name  of the first
28       attribute in the entry. To get the value of the first  attribute,  pass
29       the  attribute  name  to  the  ldap_get_values()  function  or  to  the
30       ldap_get_values_len() function.
31
32
33       The ldap_next_attribute() function gets the value of the next attribute
34       in an entry.
35
36
37       After  stepping  through  the  attributes,  the application should call
38       ber_free()  to  free  the  BerElement  structure   allocated   by   the
39       ldap_first_attribute() function if the structure is other than NULL.
40

ERRORS

42       If  an  error occurs, NULL is returned and the ld_errno field in the ld
43       parameter is set to indicate the error.  See  ldap_error(3LDAP)  for  a
44       description of possible error codes.
45

ATTRIBUTES

47       See attributes(5) for a description of the following attributes:
48
49
50
51
52       ┌─────────────────────────────┬──────────────────────────────────┐
53       │      ATTRIBUTE TYPE         │         ATTRIBUTE VALUE          │
54       ├─────────────────────────────┼──────────────────────────────────┤
55       │MT-Level                     │SUNWcsl (32-bit)SUNWcslx (64-bit) │
56       ├─────────────────────────────┼──────────────────────────────────┤
57       │Interface Stability          │Evolving                          │
58       └─────────────────────────────┴──────────────────────────────────┘
59

SEE ALSO

61       ldap(3LDAP),      ldap_first_entry(3LDAP),      ldap_get_values(3LDAP),
62       ldap_error(3LDAP), attributes(5)
63

NOTES

65       The ldap_first_attribute() function alllocates memory that  might  need
66       to be freed by the caller by means of ber_free(3LDAP).
67
68
69
70SunOS 5.11                        16 Dec 2003      ldap_first_attribute(3LDAP)
Impressum