Netscape NETSCAPE DIRECTORY SERVER 6.2 - GATEWAY CUSTOMIZATION, Manual

Page: 426 / 612

Functions for Handling Passwords
426 Netscape Directory Server Plug-In Programmer’s Guide • December 2003
slapi_pw_find_sv()
Determines whether or not a specified password matches one of the encrypted
values of an attribute. For example, you can call this function to determine if a
given password matches a value in the
userpassword
attribute.
Syntax
#include “slapi-plugin.h”
int slapi_pw_find_sv( Slapi_Value **vals, const Slapi_Value *v );
Parameters
This function takes the following parameters:
Returns
This function returns one of the following values:
• 0 if the password specified by
v
was found in
vals
.
• A non-zero value if the password
v
was not found in
vals
.
Table 15-22 Password Handling Routines
Function Description
slapi_pw_find_sv() Determines whether or not a specified password matches one of the
encrypted values of an attribute.
slapi_is_encoded() Checks whether a value is encoded with any known algorithm.
slapi_encode() Encodes a value with the specified algorithm.
vals
Pointer to the array of
Slapi_Value
structure pointers, containing the
values of an attribute that stores passwords (for example, the
userpassword
attribute).
v
Pointer to the
Slapi_Value
structure containing the password that you
wish to check (for example, you can get this value from the
SLAPI_BIND_CREDENTIALS
parameter in the parameter block and create
the
Slapi_Value
using
slapi_value_init_berval()
).