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 ]