ldap_create_group_eval_request()--Create a Group Evaluation Request Value

 #include <ldap.h>

 struct berval * ldap_create_group_eval_request (
         char           *entryDN,
         char           **attributes)

The ldap_create_group_eval_request() function is used to create a request berval for the Group Evaluation extended operation. The request contains the distinguished name (DN) of the entry for which group membership is to be determined and an optional list of attribute values for that entry. The response berval from the Group Evaluation extended operation can be used with the ldap_create_group_control() API.

Parameters

entryDN

(Input)

The DN of the entry for which group membership is to be evaluated.

attributes

(Input)

The attributes of the LDAP directory entry that are to be used when determining group membership. The strings are of the form "attribute-name=attribute-value" and the list is terminated with a null pointer.

This parameter may be null if no attributes are to be included in the group evaluation request value.

Authorities and Locks

No IBM^® i authority is required. Authority to use the Group Evaluation extended operation is determined by the LDAP server.

Return Value

Pointer to berval structure

Pointer to a berval structure that can be specified as the reqdata parameter on the ldap_extended_operation() API. The caller is responsible for freeing the allocated berval structure by calling ber_bvfree().

NULL

A memory allocation error or other error occurred. No further error information is available.

Related Information

• ber_bvfree() -- Free a Berval Structure
• ldap_create_group_control() -- Create a Group Control from a Group Evaluation Response
• ldap_extended_operation() -- Perform extended operation
• ldap_extended_operation_s() -- Perform extended operation synchronously

Example

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

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