Retrieves the authentication module plug-in instances configured for the organization (or sub-organization) defined in the am_auth_context_t type.
Module instance names are retrieved in pointer to a pointer to a am_string_set_t type (as defined in the <am_string_set.h> header file).
#include "am_auth.h" AM_EXPORT am_status_t am_auth_get_module_instance_names(am_auth_context_t auth_ctx, am_string_set_t** module_inst_names_ptr);
This function takes the following parameters:
The am_auth_context_t type.
See am_auth_context_t for information.
Pointer to a pointer to the am_string_set_t type.
This function returns a pointer to a pointer with the list of module instance names (or NULL if the number of configured modules is zero) and one of the following values of the am_status_t enumeration (defined in the <am_types.h> header file):
If the submitted requirements were processed successfully.
If the authentication process failed.
If the auth_ctx parameter is NULL.
If the OpenSSO Enterprise Authentication Service is not initialized.
The implementation takes care of allocating memory for the module_inst_names_ptr.