Netscape NETSCAPE DIRECTORY SERVER 6.2 - GATEWAY CUSTOMIZATION, Manual

Page: 378 / 612

Functions for Handling Matching Rules
378 Netscape Directory Server Plug-In Programmer’s Guide • December 2003
Returns
This function returns one of the following values:
• 0 if the information was successfully retrieved.
• -1 if an error occurred (for example, if an invalid argument was specified).
Description
This function gets information about a matching rule from the
Slapi_MatchingRuleEntry
structure. To set information in this structure, call
the
slapi_matchingrule_set()
function.
slapi_matchingrule_new()
Allocates memory for a new
Slapi_MatchingRuleEntry
structure.
Syntax
#include “slapi-plugin.h”
Slapi_MatchingRuleEntry *slapi_matchingrule_new();
Returns
This function returns one of the following values:
• A new
Slapi_MatchingRuleEntry
structure.
•
NULL
if memory could not be allocated.
Description
This function allocates memory for a new
Slapi_MatchingRuleEntry
structure, which represents a matching rule. After you call this function, you
can call the
slapi_matchingrule_set()
function to set the values in this structure
and call the
slapi_matchingrule_register()
function to register the matching
rule.
slapi_matchingrule_register()
Registers the specified matching rule with the server.
Syntax
#include “slapi-plugin.h”
int slapi_matchingrule_register(Slapi_MatchingRuleEntry *mrEntry);