1ldap_first_attribute(3LDAP) LDAP Library Functions ldap_first_attribute(3LDAP)
2
3
4
6 ldap_first_attribute, ldap_next_attribute - step through LDAP entry
7 attributes
8
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
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
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
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
61 ldap(3LDAP), ldap_first_entry(3LDAP), ldap_get_values(3LDAP),
62 ldap_error(3LDAP), attributes(5)
63
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)