ldap_create_group_control()--Create a Group Control from a Group Evaluation Response
Syntax
#include <ldap.h> LDAPControl * ldap_create_group_control( struct berval *listOfGroups)Service Program Name: QSYS/QGLDCLNT
Default Public Authority: *USE
Threadsafe: Yes
The ldap_create_group_control() function is used to create a Group Authorization control from the response value returned by the Group Evaluation extended operation. The control is always marked critical. The control can be used with other LDAP requests to specify the groups the LDAP server should use to evaluate authority when the application is acting as a proxy for another client.
Parameters
- listOfGroups
- (Input)
The response value from a Group Evaluation extended operation.
Authorities and Locks
No IBM® i authority is required. Authority to use the Group Authorization control is determined by the LDAP server.
Return Value
- Pointer to LDAPControl
- Pointer to a LDAPControl that can be used with other LDAP APIs. The caller is responsible for freeing the allocated LDAPControl structure by calling ldap_control_free().
- NULL
- A memory allocation error or other error occurred. No further error information is available.
Related Information
- ldap_control_free()--Free Storage Allocated by the LDAP Library.
- ldap_create_group_control_from_list()--Create a Group Authorization Control from a List of Groups.
- ldap_create_group_eval_request()--Create a Group Evaluation Request Value.
Example
See LDAP Group Control for an example of using ldap_create_group_control().
API introduced: V6R1
[ Back to top | LDAP APIs | APIs by category ]