18.4. slapi_modify_internal_set_pb()

Description

This function populates pblock to contain data for use by slapi_modify_internal_pb() for an internal modify operation.

For unique ID-based operation:
  • SLAPI_TARGET_DN set to the DN that allows to select the right backend.
  • SLAPI_TARGET_UNIQUEID set to the unique ID of the entry.
  • SLAPI_MODIFY_MODS set to the mods.
  • SLAPI_CONTROLS_ARG set to request controls, if present.
For DN-based search:
  • SLAPI_TARGET_DN set to the entry DN.
  • SLAPI_MODIFY_MODS set to the mods.
  • SLAPI_CONTROLS_ARG set to request controls, if present.
Syntax

  

#include "slapi-plugin.h"
void slapi_modify_internal_set_pb(Slapi_PBlock *pb, const Slapi_DN *dn, LDAPMod **mods, 
 LDAPControl **controls, const char *uniqueid, Slapi_ComponentId *plugin_identity, int operation_flags);
Parameters

This function takes the following parameters:

pb Parameter block populated with modify parameters.
dn DN of the entry to be modified. For unique ID operation, this parameter is used to select the correct backend.
mods Modifications to be applied to the entry.
controls List of controls associated with the operation.
uniqueid Unique identifier of the entry to be modified. All directory entries contain a unique identifier. Unlike the distinguished name (DN), the unique identifier of an entry never changes, providing a good way to refer unambiguously to an entry in a distributed/replicated environment.
plugin_identity Plug-in identity; a cookie that identifies the plug-in to the Directory Server during an internal operation. This cookie is used by the server to retrieve the plug-in configuration in order to determine whether to allow the operation and which actions to take during the operation processing. Plug-in identity is passed to the plug-in initialization function in the SLAPI_PLUGIN_IDENTITY pblock parameter. A plug-in must save this information and pass it to every internal operation issued by the plug-in.
operation_flags Actions taken during operation processing.