ldap_create_group_control_from_list()--Create a Group Authorization Control from a List of Groups

 #include <ldap.h>  

 LDAPControl * ldap_create_group_control_from_list (
         char           **listOfGroups,
         int            normalized)

The ldap_create_group_control_from_list() function creates a Group Authorization control structure from a list of groups. The control is always marked critical. The control can be used with other LDAP requests to specify the groups that the LDAP server should use to evaluate authority when the application is acting as a proxy for another client.

Parameters

listOfGroups

(Input)

A list of character strings containing the distinguished names (DNs) of the groups that a user belongs to. The list is terminated by a null pointer.

normalized

(Input)

The list of group DNs contains normalized values.

0

The list of DNs does not contain normalized distinguished names.

1

The list of DNs contains normalized distinguished names. Distinguished names can be normalized by using the DN Normalization 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()--Create a Group Control from a Group Evaluation Response.

Example

See LDAP Group Control for an example of using ldap_create_group_control_from_list().

[ Back to top | LDAP APIs | APIs by category ]