Calling Front-End Functions; Plug-In Return Values - Netscape DIRECTORY SERVER 6.2 - PLUG-IN Manual

Code Example 2-2
"Unable to store database information\n" );
}
...
}
Notice that this example uses the function
if an error occurred.
In this code example,
block that contains private data for use in the database functions. For a complete
listing of the parameter block IDs, see Chapter 16, "Parameter Block Reference."

Calling Front-End Functions

The types of data that you can get from a parameter block include entries,
attributes, distinguished names, and search filters. If you want to manipulate these
data items, you can call the associated front-end API functions provided with the
Directory Server. For example, using the the front-end API functions, you can:
• Write messages to the error log
• Get the attributes of an entry
• Get or set the DN of an entry
• Add or delete the values of an attribute
• Determine the OID of an attribute
• Determine the type of a search filter
For more information on the front-end API, see Chapter 5, "Front-End API
Functions" and Chapter 15, "Function Reference."

Plug-in Return Values

If your plug-in function is successful, it should return
successful, it should return a non-zero value and you should call the front-end
API function
problem ("Logging Messages" on page 58 details this process).
Setting Values in the Parameter Block (Continued)
SLAPI_PRIVATE
slapi_new_condvar()
slapi_new_condvar()
identifies the parameter in the parameter
to the front-end. If it is not
0
to log an error message to describe the
Chapter 2 Writing and Compiling Plug-Ins
Writing a Plug-In Function
to notify the user
31