Netscape NETSCAPE DIRECTORY SERVER 6.2 - GATEWAY CUSTOMIZATION, Manual

Page: 237 / 612

Functions for Setting Internal Operation Flags
Chapter 15 Function Reference 237
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.
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 unambiguously refer 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.