Content-type: text/html Man page of ldap_get_entry_controls

ldap_get_entry_controls

Section: LDAP Library Functions (3LDAP)
Updated: 6 Jan 2003
Index Return to Main Contents
 

NAME

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

SYNOPSIS

cc -flag ...  file ...-lldap [-library ...] 
#include <ldap.h>

int ldap_get_entry_controls(LDAP *ld, LDAPMessage *entry, LDAPControl ***serverctrlsp);  

DESCRIPTION

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 persistent 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 ldap_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 attributes:

ATTRIBUTE TYPEATTRIBUTE VALUE
AvailabilitySUNWcsl (32-bit)
SUNWcslx (64-bit)
Interface StabilityEvolving

 

SEE ALSO

ldap_error(3LDAP), ldap_parse_result(3LDAP), attributes(5)


 

Index

NAME
SYNOPSIS
DESCRIPTION
ERRORS
ATTRIBUTES
SEE ALSO

This document was created by man2html, using the manual pages.
Time: 02:39:16 GMT, October 02, 2010