/*

* Copyright (c) 2001-2006 Nokia Corporation and/or its subsidiary(-ies).

* All rights reserved.

* This component and the accompanying materials are made available

* under the terms of the License "Eclipse Public License v1.0"

* which accompanies this distribution, and is available

* at the URL "http://www.eclipse.org/legal/epl-v10.html".

*

* Initial Contributors:

* Nokia Corporation - initial contribution.

*

* Contributors:

*

* Description:  EAP and WLAN authentication protocols.

*

*/

#if !defined(_EAP_STATUS_H_)

#define _EAP_STATUS_H_

/** @file */ 

/// This is enumeration of status values used in EAP_Core.

/**

 * Most of the functions return type of eap_status value.

 * Each value is defined in eap_status.h. The eap_status_ok value indicates no errors. 

 * The eap_status_success value indicates the EAP-authentication was successful. 

 * Other values try to be self-documenting. 

 * The return value of every function MUST be checked. 

 * Execution of the current function MUST handle error case generated by called function. 

 * In most cases this means immediately returning the erroneous status 

 * from the current function. User MUST free the memory allocated before the error occurs. 

 * Look at the following example.

 * @code

 * // A new EAP-type is needed. The load_type() allocates new object.

 * eap_base_type *handler = load_type(used_eap_type);

 * if (handler != 0)

 * {

 *	if (handler->get_is_valid() == true)

 *	{

 * 		eap_status status = handler->configure();

 * 		if (status != eap_status_ok)

 * 		{

 * 			// Configuration failed.

 * 			delete handler;

 * 		}

 * 		EAP_TRACE_END(m_am_tools, TRACE_FLAGS_DEFAULT);

 * 		return status;

 *	}

 *	else

 *	{

 * 		// Handler not constructed successfully.

 * 		delete handler;

 * 		EAP_TRACE_END(m_am_tools, TRACE_FLAGS_DEFAULT);

 * 		return eap_status_allocation_error;

 *	}

 * }

 * else

 * {

 * 	EAP_TRACE_END(m_am_tools, TRACE_FLAGS_DEFAULT);

 * 	return eap_status_illegal_eap_type;

 * }

 * @endcode

 */

enum eap_status_e

{

	eap_status_ok, ///< This means successfull status.

	eap_status_success, ///< EAP-authentication is successful.

	eap_status_pending_request, ///< Request is pending. It will be completed later.

	eap_status_completed_request, ///< Request was completed already.

	eap_status_drop_packet_quietly, ///< Packet was dropped quietly. Just forget that packet.

	eap_status_not_supported, ///< You need to write some code to support this function.

	eap_status_process_general_error, ///< Most propably you need debugger to found reason to this error.

	eap_status_type_does_not_exists_error, ///< EAP-type is not implemented.

	eap_status_allocation_error, ///< Memory allocation failed. Try again later or release memory.

	eap_status_process_illegal_packet_error,

	eap_status_ethernet_type_not_supported,

	eap_status_illegal_eap_code,

	eap_status_illegal_eap_type,

	eap_status_illegal_eap_identity,

	eap_status_authentication_failure,

	eap_status_encryption_failure,

	eap_status_decryption_failure,

	eap_status_illegal_padding,

	eap_status_randomize_failure,

	eap_status_handler_exists_error,

	eap_status_handler_does_not_exists_error,

	eap_status_wrong_sae_state,

	eap_status_wrong_eapol_version,

	eap_status_wrong_eapol_type,

	eap_status_wrong_eapol_oui,

	eap_status_header_corrupted,

	eap_status_wrong_sae_sequence_number,

	eap_status_wrong_isakmp_header_version,

	eap_status_wrong_isakmp_exchange_type,

	eap_status_wrong_isakmp_flags,

	eap_status_wrong_isakmp_message_id,

	eap_status_wrong_isakmp_cookie,

	eap_status_unsupported_isakmp_payload,

	eap_status_key_error,

	eap_status_too_many_offers,

	eap_status_send_failed,

	eap_status_data_length_not_aligned_to_block_size,

	eap_status_wrong_network_id,

	eap_status_illegal_handle,

	eap_status_illegal_configure_field,

	eap_status_illegal_configure_type,

	eap_status_wrong_sae_header_version,

	eap_status_wrong_sae_exchange_type,

	eap_status_wrong_sae_flags,

	eap_status_unsupported_sae_payload,

	eap_status_wrong_sae_cookie,

	eap_status_illegal_encryption_parameter_size,

	eap_status_state_reference_count_not_zero,

	eap_status_illegal_nai,

	eap_status_illegal_nai_payload,

	eap_status_illegal_data_payload,

	eap_status_illegal_payload,

	eap_status_illegal_hashed_index,

	eap_status_wrong_gsmsim_state,

	eap_status_wrong_eap_type_state, ///< Use this instead of eap_status_wrong_gsmsim_state.

	eap_status_unsupported_gsmsim_payload,

	eap_status_unsupported_payload, ///< Use this instead of eap_status_unsupported_gsmsim_payload.

	eap_status_gsmsim_triplet_query_failed,

	eap_status_illegal_index,

	eap_status_timed_out,

	eap_status_wrong_eap_subtype,

	eap_status_exit_test,

	eap_status_no_matching_protocol_version,

	eap_status_too_short_message,

	eap_status_too_long_message,

	eap_status_hardware_not_ready,

	eap_status_wrong_protocol,

	eap_status_wrong_type,

	eap_status_illegal_parameter,

	eap_status_illegal_certificate,

	eap_status_illegal_cipher_suite,

	eap_status_bad_certificate,

	eap_status_unsupported_certificate,

	eap_status_certificate_revoked,

	eap_status_certificate_expired,

	eap_status_ca_certificate_unknown,

	eap_status_user_certificate_unknown,

	eap_status_unknown_ca,

	eap_status_access_denied,

	eap_status_unexpected_message,

	eap_status_buffer_too_short,

	eap_status_not_found,

	eap_status_not_enough_challenges,

	eap_status_not_fresh_challenges,

	eap_status_already_exists,

	eap_status_insufficient_security,

	eap_status_syncronization_failure,

	eap_status_file_does_not_exist,

	eap_status_end_of_file,

	eap_status_file_write_failed,

	eap_status_wrong_authentication_type,

	eap_status_section_ends,

	eap_status_missing_payload,

	eap_status_realm_check_failed,

	eap_status_identity_query_failed,

	eap_status_credential_query_failed,

	eap_status_user_has_not_subscribed_to_the_requested_service,

	eap_status_users_calls_are_barred,

	eap_status_restricted_logon_hours,

	eap_status_account_disabled,

	eap_status_no_dialin_permission,

	eap_status_password_expired,

	eap_status_wrong_password,

	eap_status_oob_interface_read_error,

	eap_status_decryption_crc_failure,

	eap_status_rf_band_2_4_ghz_not_supported,

	eap_status_rf_band_5_0_ghz_not_supported,

	eap_status_signal_too_weak,

	eap_status_network_authentication_failure,

	eap_status_network_association_failure,

	eap_status_no_dhcp_response,

	eap_status_failed_dhcp_configure,

	eap_status_ip_address_conflict,

	eap_status_could_not_connect_to_registrar,

	eap_status_multiple_pbc_sessions_detected,

	eap_status_rogue_activity_suspected,

	eap_status_device_busy,

	eap_status_setup_locked,

	eap_status_message_timeout,

	eap_status_registration_session_timeout,

	eap_status_device_password_authentication_failure,

	eap_status_pin_code_authentication_not_supported,

	eap_status_push_button_authentication_not_supported,

	eap_status_end_recursion,

	eap_status_tunnel_compromise_error,

	eap_status_unexpected_tlv_exhanged,

	eap_status_no_pac_nor_certs_to_authenticate_with_provision_disabled,

	eap_status_no_matching_pac_for_aid,

	eap_status_pac_store_corrupted,

	eap_status_user_cancel_authentication,

	eap_status_no_match,

};

#endif //#if !defined(_EAP_STATUS_H_)

// End.