Netscape DIRECTORY SERVER 6.1 - PLUG-IN Manual page 238

Functions for Setting Internal Operation Flags
slapi_rename_internal_set_pb()
Sets up a parameter block so that it can be used by
for an internal rename operation.
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
238 Netscape Directory Server Plug-In Programmer's Guide • August 2002
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 unambiguously refer 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.
slapi_modrdn_internal_pb()