Front cover - IBM Redbooks

}
return kFilterNotHandled;
/*---
* handle user authentication
*/
unsigned int Authenticate(FilterContext* context,
FilterAuthenticate* authData)
{
/*
* Description: This routine is called on a dsapi kFilterAuthUser
* event.
*
* Input: context dsapi specification controls the format of data
*
* authData password field contains the password to use for
* authentication
* userName field contains the name
* to authenticate
* foundInCache field is TRUE if
* user has been found in the cache and can be
* authenticated on that basis.
*
* Output: authData authName field is filled with user's
* distinguished name
* authType filed is filled
* with kNotAuthentic if we can't authenticate the
* user kAuthenticBasic if we can
* authenticate the user.
*
* Return: kFilterNotHandled if we do not understand the input data,
* or if the user has been found in the cache, or
* if we find that the user to be authenticated is
* not known to OS.
* kFilterHandledEvent if the user is known to OS.
*/
/* If the user is found in the cache, then we don't need to do
* anything further.
*/
if (!authData || authData->foundInCache) {
AddInLogMessageText ("\n user is found in the cache \n", NOERROR);
return kFilterNotHandled;
}
/* Attempt to verify the user's password.
Appendix B. A sample DSAPI program 647