Netscape DIRECTORY SERVER 7.0 - PLUG-IN Manual page 250

Functions for Setting Internal Operation Flags
scope
filter
attrs
attrsonly
controls
uniqueid
plugin_identity
operation_flags
Description
This function sets up the parameter block, for subsequent use by
slapi_search_internal_pb()
search operation.
For unique ID-based search:
•
SLAPI_TARGET_DN
•
SLAPI_TARGET_UNIQUEID
For DN-based search:
•
SLAPI_TARGET_DN
•
SLAPI_SEARCH_SCOPE
250 Netscape Directory Server Plug-in Programmer's Guide • October 2004
Search scope (LDAP_SCOPE_SUBTREE, etc.).
Search filter.
Attributes to be returned.
Flag specifying whether to return just attribute names or names
and values.
List of controls associated with the operation.
Unique identifier of the entry. Non-NULL value indicates
unique ID-based search. In this case, scope and filter are ignored;
however, base is still required and is used to select the correct
backend.
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.
, to contain the following data for an internal
set to the DN that allows to select the right backend.
set to the unique ID of the entry.
set to the search base.
set to the search scope.