LDAP Library Functions ldap_get_entry_controls(3LDAP)
NAME
ldap_get_entry_controls - get the LDAP controls included
with a directory entry in a set of search resultsSYNOPSIS
cc-flag ... file...-lldap [ -library ... ]
#include
int ldap_get_entry_controls(LDAP *ld, LDAPMessage *entry,
LDAPControl ***serverctrlspDESCRIPTION
The ldap_get_entry_controls() 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 callldap_parse_result() to retrieve those controls.
ERRORS
ldap_get_entry_controls() returns the following error codes.
LDAP_SUCCESS LDAP controls were successfully
retrieved.LDAP_DECODING_ERROR An error occurred when decoding the
BER-encoded message.
LDAP_PARAM_ERROR An invalid parameter was passed to
the function.LDAP_NO_MEMORY Memory cannot be allocated.
ATTRIBUTES
See attributes(5) for descriptions of the following attri-
butes:SunOS 5.11 Last change: 6 Jan 2003 1
LDAP Library Functions ldap_get_entry_controls(3LDAP)
____________________________________________________________
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
|_____________________________|_____________________________|
| Availability | system/library (32-bit) |
|_____________________________|_____________________________|
| | SUNWcslx (64-bit) |
|_____________________________|_____________________________|
| Interface Stability | Committed ||_____________________________|_____________________________|
SEE ALSO
ldap_error(3LDAP), ldap_parse_result(3LDAP), attributes(5)
SunOS 5.11 Last change: 6 Jan 2003 2