Calling Front-End Functions; Plug-In Return Values - Netscape DIRECTORY SERVER 7.0 - 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
("Logging Messages," on page 67, 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 log an error message to describe the problem
Chapter 2
Writing a Plug-in Function
to notify the user
to the front-end. If it is not
0
Writing and Compiling Plug-ins 41