ldap_create_modify_groups_only_control()--Create a Modify Groups Only Control

Syntax

 #include <ldap.h > 
 
 int ldap_create_modify_groups_only_control(
        LDAP *ld,
        LDAPControl **control)

  Service Program Name: QSYS/QGLDCLNT

  Default Public Authority:*USE

  Threadsafe: Yes

The ldap_create_modify_groups_only_control() function is used to create a Modify Groups Only control. The Modify Groups Only control is used to cause an LDAP server to do only the group referential integrity processing for a delete or rename operation without doing the actual deletion or renaming itself.

Parameters

ld: (Input)
The LDAP pointer returned by a previous call to ldap_init() or ldap_ssl_init().
control: (Output)
The address in which a pointer to the allocated LDAPControl is returned. The caller must free the returned LDAPControl using ldap_control_free().

Authorities and Locks

No IBM^® i authority is required. Authority to use the Modify Groups Only control is determined by the LDAP server.

Return Value

LDAP_SUCCESS: if the request was successful.
another LDAP error: if the request was not successful. See LDAP Client API Error Conditions for possible LDAP error code values.

Related Information

ldap_control_free()--Free Storage Allocated by the LDAP Library.

API introduced: V6R1

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