Begins the login process given the index type and its value.
#include "am_auth.h" AM_EXPORT am_status_t am_auth_login(am_auth_context_t auth_ctx, am_auth_index_t auth_idx, const char *value);
This function takes the following parameters:
The am_auth_context_t type.
See am_auth_context_t for information.
Defines the resource for which the authentication is being performed. Based on the am_auth_index_t enumeration used to initiate the login process:
typedef enum am_auth_idx { AM_AUTH_INDEX_AUTH_LEVEL = 0, AM_AUTH_INDEX_ROLE, AM_AUTH_INDEX_USER, AM_AUTH_INDEX_MODULE_INSTANCE, AM_AUTH_INDEX_SERVICE } am_auth_index_t;
Pointer to the authentication module being used.
See Authentication Module Types in Sun Java System Access Manager 7.1 Administration Guide for more information.
This function returns one of the following values of the am_status_t enumeration (defined in the <am_types.h> header file):
If the login process was successfully completed.
If the auth_ctx or value parameter is NULL.
If the auth_idx parameter is invalid.