Creates the context for the authentication and a pointer to it.
#include "am_auth.h" AM_EXPORT am_status_t am_auth_create_auth_context(am_auth_context_t *auth_ctx, const char *org_name, const char *cert_nick_name, const char *url);
This function takes the following parameters:
Pointer to the am_auth_context_t type.
See am_auth_context_t for information.
Pointer to the name of the organization for which the authentication context is being initialized. May be NULL to use the value defined in the agent configuration properties.
Pointer to the alias of the certificate being used if the application will connect securely to OpenSSO Enterprise. May be NULL if the connection is not secure.
Pointer to the OpenSSO Enterprise Naming Service URL. May be NULL to use the Naming Service URL defined in the agent configuration properties.
This function returns a pointer to the authentication context object and one of the following values of the am_status_t enumeration (defined in the <am_types.h> header file):
If the authentication context was successfully created.
If unable to allocate memory for the handle.
If the auth_ctx parameter is NULL.
If the authentication initialization failed.