SDK Guide › Exits API › UserDefinedFunction Function

UserDefinedFunction Function

Valid on Windows

The UserDefinedFunction function is registered with a specific event type when the seosd service and the pwdchange.dll start. It is called according to the event type.

If the function succeeds, it returns 0. Any other numbers indicate a failure; the execution continues as usual-as if no callback function was called.

int UserDefinedFunction(void* data, SEOS_EXITRES * pExitResult);

data

A structure corresponding to the event type with which this function was registered. The data is cast into the following structures:

• SEOS_EXITGENR-For the following event types: AUTHXAPI_EV_PREGNRES, AUTHXAPI_EV_POSTGNRES.
• SEOS_EXITLOGIN-For the following event types: AUTHXAPI_EV_PRELOGIN, AUTHXAPI_EV_POSTLOGIN.
• SEOS_EXITPASS-For the following event types: AUTHXAPI_EV_PREVERPWD, AUTHXAPI_EV_POSTVERPWD, AUTHXAPI_EV_PRESETPWD, AUTHXAPI_EV_POSTSETPWD.

pExitResult

A pointer for the result structure which the exit function fills with information.

Example

Defining a user's exit function.

/* Sample function to deny all login attempts of user 'jsmith' */
int MyExitFunc(void *exit_data, SEOS_EXITRES *res)
{
     SEOS_EXITLOGIN *login_data;
     login_data = (SEOS_EXITLOGIN *)exit_data;
If (login_data->szUname != NULL)
     {
          if (strcmp(login_data->szUname, “jsmith”))
               return 0;
          res->result = SEOS_EXITR_DENY;
     }
     return 0;
}