eapol/eapol_framework/eapol_common/include/eap_general_settings_client_message_if.h
author hgs
Mon, 24 May 2010 20:32:47 +0300
changeset 26 9abfd4f00d37
child 49 43351a4f2da3
permissions -rw-r--r--
201021
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
26
hgs
parents:
diff changeset
     1
/*
hgs
parents:
diff changeset
     2
* Copyright (c) 2001-2006 Nokia Corporation and/or its subsidiary(-ies).
hgs
parents:
diff changeset
     3
* All rights reserved.
hgs
parents:
diff changeset
     4
* This component and the accompanying materials are made available
hgs
parents:
diff changeset
     5
* under the terms of the License "Eclipse Public License v1.0"
hgs
parents:
diff changeset
     6
* which accompanies this distribution, and is available
hgs
parents:
diff changeset
     7
* at the URL "http://www.eclipse.org/legal/epl-v10.html".
hgs
parents:
diff changeset
     8
*
hgs
parents:
diff changeset
     9
* Initial Contributors:
hgs
parents:
diff changeset
    10
* Nokia Corporation - initial contribution.
hgs
parents:
diff changeset
    11
*
hgs
parents:
diff changeset
    12
* Contributors:
hgs
parents:
diff changeset
    13
*
hgs
parents:
diff changeset
    14
* Description:  Class creates and reads the messages used in EAP-general settings interface on the client side.
hgs
parents:
diff changeset
    15
*
hgs
parents:
diff changeset
    16
*/
hgs
parents:
diff changeset
    17
hgs
parents:
diff changeset
    18
/*
hgs
parents:
diff changeset
    19
* %version: 8 %
hgs
parents:
diff changeset
    20
*/
hgs
parents:
diff changeset
    21
hgs
parents:
diff changeset
    22
#if !defined(_EAP_GENERAL_SETTINGS_CLIENT_MESSAGE_IF_H_)
hgs
parents:
diff changeset
    23
#define _EAP_GENERAL_SETTINGS_CLIENT_MESSAGE_IF_H_
hgs
parents:
diff changeset
    24
hgs
parents:
diff changeset
    25
#include "eap_tools.h"
hgs
parents:
diff changeset
    26
#include "eap_am_export.h"
hgs
parents:
diff changeset
    27
#include "eap_plugin_message_base.h"
hgs
parents:
diff changeset
    28
#include "abs_eap_am_message_if.h"
hgs
parents:
diff changeset
    29
#include "eap_array.h"
hgs
parents:
diff changeset
    30
#include "eap_process_tlv_message_data.h"
hgs
parents:
diff changeset
    31
#include "eap_general_settings_message.h"
hgs
parents:
diff changeset
    32
hgs
parents:
diff changeset
    33
class eap_method_settings_c;
hgs
parents:
diff changeset
    34
class eap_am_message_if_c;
hgs
parents:
diff changeset
    35
class abs_eap_general_settings_message_c;
hgs
parents:
diff changeset
    36
class eap_tlv_header_c;
hgs
parents:
diff changeset
    37
hgs
parents:
diff changeset
    38
/// Class creates and reads the messages used in EAP-general settings interface on the client side.
hgs
parents:
diff changeset
    39
class EAP_EXPORT eap_general_settings_client_message_if_c
hgs
parents:
diff changeset
    40
: public abs_eap_am_message_if_c
hgs
parents:
diff changeset
    41
, public eap_general_settings_message_c
hgs
parents:
diff changeset
    42
{
hgs
parents:
diff changeset
    43
private:
hgs
parents:
diff changeset
    44
	//--------------------------------------------------
hgs
parents:
diff changeset
    45
hgs
parents:
diff changeset
    46
	/// This is pointer to the tools class.
hgs
parents:
diff changeset
    47
	abs_eap_am_tools_c * const m_am_tools;
hgs
parents:
diff changeset
    48
hgs
parents:
diff changeset
    49
	/// eap_general_settings_client_message_if_c deletes m_client_if in destructor.
hgs
parents:
diff changeset
    50
	eap_am_message_if_c * m_client_if;
hgs
parents:
diff changeset
    51
hgs
parents:
diff changeset
    52
	/// This is back pointer to object which created this object.
hgs
parents:
diff changeset
    53
	/// Packets are sent to the partner.
hgs
parents:
diff changeset
    54
	abs_eap_general_settings_message_c * const m_partner;
hgs
parents:
diff changeset
    55
hgs
parents:
diff changeset
    56
	/// This indicates whether this object was generated successfully.
hgs
parents:
diff changeset
    57
	bool m_is_valid;
hgs
parents:
diff changeset
    58
hgs
parents:
diff changeset
    59
	eap_status_e m_error_code;
hgs
parents:
diff changeset
    60
hgs
parents:
diff changeset
    61
	eap_tlv_message_type_function_e m_error_function;
hgs
parents:
diff changeset
    62
hgs
parents:
diff changeset
    63
hgs
parents:
diff changeset
    64
	eap_status_e complete_set_eap_methods(
hgs
parents:
diff changeset
    65
		EAP_TEMPLATE_CONST eap_array_c<eap_tlv_header_c> * const parameters);
hgs
parents:
diff changeset
    66
hgs
parents:
diff changeset
    67
	eap_status_e complete_get_eap_methods(
hgs
parents:
diff changeset
    68
		EAP_TEMPLATE_CONST eap_array_c<eap_tlv_header_c> * const parameters);
hgs
parents:
diff changeset
    69
hgs
parents:
diff changeset
    70
	eap_status_e complete_get_certificate_lists(
hgs
parents:
diff changeset
    71
		EAP_TEMPLATE_CONST eap_array_c<eap_tlv_header_c> * const parameters);
hgs
parents:
diff changeset
    72
hgs
parents:
diff changeset
    73
	eap_status_e complete_delete_all_eap_settings(
hgs
parents:
diff changeset
    74
		EAP_TEMPLATE_CONST eap_array_c<eap_tlv_header_c> * const parameters);
hgs
parents:
diff changeset
    75
hgs
parents:
diff changeset
    76
	eap_status_e complete_copy_all_eap_settings(
hgs
parents:
diff changeset
    77
		EAP_TEMPLATE_CONST eap_array_c<eap_tlv_header_c> * const parameters);
hgs
parents:
diff changeset
    78
hgs
parents:
diff changeset
    79
hgs
parents:
diff changeset
    80
	eap_status_e process_message_type_error(
hgs
parents:
diff changeset
    81
		EAP_TEMPLATE_CONST eap_array_c<eap_tlv_header_c> * const parameters);
hgs
parents:
diff changeset
    82
hgs
parents:
diff changeset
    83
	eap_status_e process_message(eap_process_tlv_message_data_c * const message);
hgs
parents:
diff changeset
    84
hgs
parents:
diff changeset
    85
	//--------------------------------------------------
hgs
parents:
diff changeset
    86
protected:
hgs
parents:
diff changeset
    87
	//--------------------------------------------------
hgs
parents:
diff changeset
    88
hgs
parents:
diff changeset
    89
	//--------------------------------------------------
hgs
parents:
diff changeset
    90
public:
hgs
parents:
diff changeset
    91
	//--------------------------------------------------
hgs
parents:
diff changeset
    92
hgs
parents:
diff changeset
    93
	/**
hgs
parents:
diff changeset
    94
	 * The destructor of the eap_core class does nothing special.
hgs
parents:
diff changeset
    95
	 */
hgs
parents:
diff changeset
    96
	EAP_FUNC_IMPORT virtual ~eap_general_settings_client_message_if_c();
hgs
parents:
diff changeset
    97
hgs
parents:
diff changeset
    98
	/**
hgs
parents:
diff changeset
    99
	 * The constructor initializes member attributes using parameters passed to it.
hgs
parents:
diff changeset
   100
	 * @param tools is pointer to the tools class. @see abs_eap_am_tools_c.
hgs
parents:
diff changeset
   101
	 * @param client_if is pointer to object which forwards message to the server.
hgs
parents:
diff changeset
   102
	 * @param partner is back pointer to the user of EAP-general settings.
hgs
parents:
diff changeset
   103
	 */
hgs
parents:
diff changeset
   104
	EAP_FUNC_IMPORT eap_general_settings_client_message_if_c(
hgs
parents:
diff changeset
   105
		abs_eap_am_tools_c * const tools,
hgs
parents:
diff changeset
   106
		eap_am_message_if_c * const client_if,
hgs
parents:
diff changeset
   107
		abs_eap_general_settings_message_c * const partner);
hgs
parents:
diff changeset
   108
hgs
parents:
diff changeset
   109
	/**
hgs
parents:
diff changeset
   110
	 * This function must reset the state of object to same as 
hgs
parents:
diff changeset
   111
	 * state was after the configure() function call.
hgs
parents:
diff changeset
   112
	 * If object reset succeeds this function must return eap_status_ok.
hgs
parents:
diff changeset
   113
	 * If object reset fails this function must return corresponding error status.
hgs
parents:
diff changeset
   114
	 * @return This function returns the status of reset operation.
hgs
parents:
diff changeset
   115
	 */
hgs
parents:
diff changeset
   116
	EAP_FUNC_IMPORT eap_status_e reset();
hgs
parents:
diff changeset
   117
hgs
parents:
diff changeset
   118
	// This is documented in abs_eap_stack_interface_c::configure().
hgs
parents:
diff changeset
   119
	EAP_FUNC_IMPORT eap_status_e configure();
hgs
parents:
diff changeset
   120
hgs
parents:
diff changeset
   121
	// This is documented in abs_eap_stack_interface_c::shutdown().
hgs
parents:
diff changeset
   122
	EAP_FUNC_IMPORT eap_status_e shutdown();
hgs
parents:
diff changeset
   123
hgs
parents:
diff changeset
   124
	// This is documented in abs_eap_stack_interface_c::get_is_valid().
hgs
parents:
diff changeset
   125
	EAP_FUNC_IMPORT bool get_is_valid();
hgs
parents:
diff changeset
   126
hgs
parents:
diff changeset
   127
	EAP_FUNC_IMPORT eap_status_e get_eap_methods(const eap_method_settings_c * const internal_settings);
hgs
parents:
diff changeset
   128
hgs
parents:
diff changeset
   129
	EAP_FUNC_IMPORT eap_status_e set_eap_methods(const eap_method_settings_c * const internal_settings);
hgs
parents:
diff changeset
   130
hgs
parents:
diff changeset
   131
	EAP_FUNC_IMPORT eap_status_e get_certificate_lists(const eap_method_settings_c * const internal_settings);
hgs
parents:
diff changeset
   132
hgs
parents:
diff changeset
   133
	EAP_FUNC_IMPORT eap_status_e delete_all_eap_settings(const eap_method_settings_c * const internal_settings);
hgs
parents:
diff changeset
   134
hgs
parents:
diff changeset
   135
	EAP_FUNC_IMPORT eap_status_e copy_all_eap_settings(const eap_method_settings_c * const internal_settings);
hgs
parents:
diff changeset
   136
hgs
parents:
diff changeset
   137
	EAP_FUNC_IMPORT eap_status_e send_data(const void * const data, const u32_t length);
hgs
parents:
diff changeset
   138
hgs
parents:
diff changeset
   139
	//--------------------------------------------------
hgs
parents:
diff changeset
   140
}; // class eap_general_settings_client_message_if_c
hgs
parents:
diff changeset
   141
hgs
parents:
diff changeset
   142
//--------------------------------------------------
hgs
parents:
diff changeset
   143
hgs
parents:
diff changeset
   144
#endif //#if !defined(_EAP_GENERAL_SETTINGS_CLIENT_MESSAGE_IF_H_)
hgs
parents:
diff changeset
   145
hgs
parents:
diff changeset
   146
//--------------------------------------------------
hgs
parents:
diff changeset
   147
hgs
parents:
diff changeset
   148
hgs
parents:
diff changeset
   149
hgs
parents:
diff changeset
   150
// End.