Slapi_Rename_Internal_Set_Pb() - Netscape DIRECTORY SERVER 7.0 - PLUG-IN Manual

Functions for Setting Internal Operation Flags

slapi_rename_internal_set_pb()

Sets up a parameter block so that it can be used by
slapi_modrdn_internal_pb()
Syntax
#include "slapi-plugin.h"
void slapi_rename_internal_set_pb(Slapi_PBlock *pb,
const char *olddn, const char *newrdn, const char *newsuperior,
int deloldrdn, LDAPControl **controls, const char *uniqueid,
Slapi_ComponentId *plugin_identity, int operation_flags);
Parameters
This function takes the following parameters:
pb
olddn
newrdn
newsuperior
deloldrdn
controls
uniqueid
plugin_identity
operation_flags
248 Netscape Directory Server Plug-in Programmer's Guide • October 2004
for an internal rename operation.
Parameter block populated with rename parameters.
DN of the entry to be renamed. For unique ID operation, this
parameter is used to select the correct backend.
New RDN of the entry.
New entry superior, moddn operation only.
Specifies whether the old RDN should be removed or left as a
non-DN attribute.
List of controls associated with the operation.
Unique identifier of the entry to be renamed.
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.
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.
Actions taken during operation processing.