eapol/eapol_framework/eapol_common/core/eap_general_settings_server_message_if.cpp
branchRCL_3
changeset 46 c74b3d9f6b9e
parent 45 bad0cc58d154
child 55 9c2aa05919d9
equal deleted inserted replaced
45:bad0cc58d154 46:c74b3d9f6b9e
     1 /*
       
     2 * Copyright (c) 2001-2010 Nokia Corporation and/or its subsidiary(-ies).
       
     3 * All rights reserved.
       
     4 * This component and the accompanying materials are made available
       
     5 * under the terms of the License "Eclipse Public License v1.0"
       
     6 * which accompanies this distribution, and is available
       
     7 * at the URL "http://www.eclipse.org/legal/epl-v10.html".
       
     8 *
       
     9 * Initial Contributors:
       
    10 * Nokia Corporation - initial contribution.
       
    11 *
       
    12 * Contributors:
       
    13 *
       
    14 * Description:  Class creates and reads the messages used in EAP-general settings interface on the server side.
       
    15 *
       
    16 */
       
    17 
       
    18 /*
       
    19 * %version: 14 %
       
    20 */
       
    21 
       
    22 // This is enumeration of EAPOL source code.
       
    23 #if defined(USE_EAP_MINIMUM_RELEASE_TRACES)
       
    24 	#undef EAP_FILE_NUMBER_ENUM
       
    25 	#define EAP_FILE_NUMBER_ENUM 744 
       
    26 	#undef EAP_FILE_NUMBER_DATE 
       
    27 	#define EAP_FILE_NUMBER_DATE 1127594498 
       
    28 #endif //#if defined(USE_EAP_MINIMUM_RELEASE_TRACES)
       
    29 
       
    30 
       
    31 
       
    32 #include "eap_am_memory.h"
       
    33 #include "eap_tools.h"
       
    34 #include "eap_general_settings_server_message_if.h"
       
    35 #include "eap_crypto_api.h"
       
    36 #include "eap_state_notification.h"
       
    37 #include "eap_automatic_variable.h"
       
    38 #include "eap_network_id_selector.h"
       
    39 #include "eap_config.h"
       
    40 #include "eap_am_general_settings.h"
       
    41 
       
    42 //--------------------------------------------------
       
    43 
       
    44 // 
       
    45 EAP_FUNC_EXPORT eap_general_settings_server_message_if_c::~eap_general_settings_server_message_if_c()
       
    46 {
       
    47 	EAP_TRACE_BEGIN(m_am_tools, TRACE_FLAGS_DEFAULT);
       
    48 
       
    49 	EAP_TRACE_DEBUG(
       
    50 		m_am_tools, 
       
    51 		EAP_TRACE_FLAGS_MESSAGE_DATA, 
       
    52 		(EAPL("eap_general_settings_server_message_if_c::~eap_general_settings_server_message_if_c(): this = 0x%08x\n"),
       
    53 		this));
       
    54 
       
    55 	EAP_ASSERT(m_shutdown_was_called == true);
       
    56 
       
    57 	delete m_am_settings;
       
    58 
       
    59 	EAP_TRACE_END(m_am_tools, TRACE_FLAGS_DEFAULT);
       
    60 }
       
    61 
       
    62 //--------------------------------------------------
       
    63 
       
    64 #if defined(_WIN32) && !defined(__GNUC__)
       
    65 	#pragma warning( disable : 4355 ) // 'this' : used in base member initializer list
       
    66 #endif
       
    67 
       
    68 // 
       
    69 EAP_FUNC_EXPORT eap_general_settings_server_message_if_c::eap_general_settings_server_message_if_c(
       
    70 	abs_eap_am_tools_c * const tools)
       
    71 	: m_partner(0)
       
    72 	, m_am_settings(new_eap_am_general_settings_c(tools, this))
       
    73 	, m_am_tools(tools)
       
    74 	, m_error_code(eap_status_ok)
       
    75 	, m_error_function(eap_tlv_message_type_function_none)
       
    76 	, m_is_valid(false)
       
    77 	, m_shutdown_was_called(false)
       
    78 {
       
    79 	EAP_TRACE_BEGIN(m_am_tools, TRACE_FLAGS_DEFAULT);
       
    80 
       
    81 	EAP_TRACE_DEBUG(
       
    82 		m_am_tools, 
       
    83 		EAP_TRACE_FLAGS_MESSAGE_DATA, 
       
    84 		(EAPL("eap_general_settings_server_message_if_c::eap_general_settings_server_message_if_c(): %s, this = 0x%08x => 0x%08x, compiled %s %s.\n"),
       
    85 		(m_is_client == true) ? "client": "server",
       
    86 		this,
       
    87 		dynamic_cast<abs_eap_base_timer_c *>(this),
       
    88 		__DATE__,
       
    89 		__TIME__));
       
    90 
       
    91 	if (m_am_settings != 0
       
    92 		&& m_am_settings->get_is_valid() == true)
       
    93 	{
       
    94 		set_is_valid();
       
    95 	}
       
    96 
       
    97 	EAP_TRACE_END(m_am_tools, TRACE_FLAGS_DEFAULT);
       
    98 }
       
    99 
       
   100 //--------------------------------------------------
       
   101 
       
   102 //
       
   103 EAP_FUNC_EXPORT eap_status_e eap_general_settings_server_message_if_c::configure(
       
   104 	const eap_variable_data_c * const /* client_configuration */)
       
   105 {
       
   106 	EAP_ASSERT(m_am_tools->get_global_mutex()->get_is_reserved() == true);
       
   107 
       
   108 	EAP_TRACE_DEBUG(
       
   109 		m_am_tools,
       
   110 		EAP_TRACE_FLAGS_MESSAGE_DATA,
       
   111 		(EAPL("%s: eap_general_settings_server_message_if_c::configure()\n"),
       
   112 		(m_is_client == true) ? "client": "server"));
       
   113 
       
   114 	EAP_TRACE_RETURN_STRING_FLAGS(m_am_tools, EAP_TRACE_FLAGS_MESSAGE_DATA, "returns: eap_general_settings_server_message_if_c::configure()");
       
   115 
       
   116 	eap_status_e status(eap_status_process_general_error);
       
   117 
       
   118 	if (m_am_settings != 0)
       
   119 	{
       
   120 		status = m_am_settings->configure();
       
   121 		if (status != eap_status_ok)
       
   122 		{
       
   123 			EAP_TRACE_END(m_am_tools, TRACE_FLAGS_DEFAULT);
       
   124 			return EAP_STATUS_RETURN(m_am_tools, status);
       
   125 		}
       
   126 	}
       
   127 
       
   128 	return EAP_STATUS_RETURN(m_am_tools, status);
       
   129 }
       
   130 
       
   131 //--------------------------------------------------
       
   132 
       
   133 //
       
   134 EAP_FUNC_EXPORT eap_status_e eap_general_settings_server_message_if_c::shutdown()
       
   135 {
       
   136 	EAP_TRACE_DEBUG(
       
   137 		m_am_tools,
       
   138 		EAP_TRACE_FLAGS_MESSAGE_DATA,
       
   139 		(EAPL("%s: eap_general_settings_server_message_if_c::shutdown(), m_shutdown_was_called=%d\n"),
       
   140 		(m_is_client == true) ? "client": "server",
       
   141 		m_shutdown_was_called));
       
   142 
       
   143 	EAP_TRACE_RETURN_STRING_FLAGS(m_am_tools, EAP_TRACE_FLAGS_MESSAGE_DATA, "returns: eap_general_settings_server_message_if_c::shutdown()");
       
   144 
       
   145 	EAP_ASSERT(m_am_tools->get_global_mutex()->get_is_reserved() == true);
       
   146 
       
   147 	if (m_shutdown_was_called == true)
       
   148 	{
       
   149 		// Shutdown function was called already.
       
   150 		return EAP_STATUS_RETURN(m_am_tools, eap_status_ok);
       
   151 	}
       
   152 	m_shutdown_was_called = true;
       
   153 
       
   154 	if (m_am_settings != 0)
       
   155 	{
       
   156 		(void) m_am_settings->shutdown();
       
   157 	}
       
   158 
       
   159 	return EAP_STATUS_RETURN(m_am_tools, eap_status_ok);
       
   160 }
       
   161 
       
   162 //--------------------------------------------------
       
   163 
       
   164 //
       
   165 EAP_FUNC_EXPORT void eap_general_settings_server_message_if_c::set_partner(abs_eap_am_message_if_c * const partner)
       
   166 {
       
   167 	m_partner = partner;
       
   168 }
       
   169 
       
   170 //--------------------------------------------------
       
   171 
       
   172 EAP_FUNC_EXPORT eap_status_e eap_general_settings_server_message_if_c::send_error_message(
       
   173 	const eap_status_e error_code,
       
   174 	const eap_tlv_message_type_function_e function)
       
   175 {
       
   176 	eap_status_e status(eap_status_ok);
       
   177 
       
   178 	{
       
   179 		// Creates message data composed of Attribute-Value Pairs.
       
   180 		eap_process_tlv_message_data_c message(m_am_tools);
       
   181 
       
   182 		if (message.get_is_valid() == false)
       
   183 		{
       
   184 			EAP_TRACE_END(m_am_tools, TRACE_FLAGS_DEFAULT);
       
   185 			return EAP_STATUS_RETURN(m_am_tools, eap_status_allocation_error);
       
   186 		}
       
   187 
       
   188 		status = message.add_parameter_data(
       
   189 			eap_tlv_message_type_error,
       
   190 			static_cast<u32_t>(error_code));
       
   191 		if (status != eap_status_ok)
       
   192 		{
       
   193 			EAP_TRACE_END(m_am_tools, TRACE_FLAGS_DEFAULT);
       
   194 			return EAP_STATUS_RETURN(m_am_tools, status);
       
   195 		}
       
   196 
       
   197 		status = message.add_parameter_data(function);
       
   198 		if (status != eap_status_ok)
       
   199 		{
       
   200 			EAP_TRACE_END(m_am_tools, TRACE_FLAGS_DEFAULT);
       
   201 			return EAP_STATUS_RETURN(m_am_tools, status);
       
   202 		}
       
   203 
       
   204 		status = send_message(&message);
       
   205 	}
       
   206 
       
   207 	EAP_TRACE_END(m_am_tools, TRACE_FLAGS_DEFAULT);
       
   208 	return EAP_STATUS_RETURN(m_am_tools, eap_status_ok);
       
   209 }
       
   210 
       
   211 //--------------------------------------------------
       
   212 
       
   213 EAP_FUNC_EXPORT eap_status_e eap_general_settings_server_message_if_c::send_message(eap_process_tlv_message_data_c * const message)
       
   214 {
       
   215 	// Sends message data composed of Attribute-Value Pairs.
       
   216 
       
   217 	EAP_TRACE_DEBUG(
       
   218 		m_am_tools, 
       
   219 		EAP_TRACE_FLAGS_MESSAGE_DATA, 
       
   220 		(EAPL("eap_general_settings_server_message_if_c::send_message(): this = 0x%08x => 0x%08x.\n"),
       
   221 		this,
       
   222 		dynamic_cast<abs_eap_base_timer_c *>(this)));
       
   223 
       
   224 	EAP_TRACE_DATA_DEBUG(
       
   225 		m_am_tools,
       
   226 		EAP_TRACE_FLAGS_NEVER,
       
   227 		(EAPL("eap_core_client_message_if_c::send_message()"),
       
   228 		message->get_message_data(),
       
   229 		message->get_message_data_length()));
       
   230 
       
   231 	EAP_TRACE_RETURN_STRING_FLAGS(m_am_tools, EAP_TRACE_FLAGS_MESSAGE_DATA, "returns: eap_core_client_message_if_c::send_message()");
       
   232 
       
   233 
       
   234 	eap_status_e send_status = m_partner->send_data(
       
   235 		message->get_message_data(),
       
   236 		message->get_message_data_length());
       
   237 
       
   238 	EAP_TRACE_END(m_am_tools, TRACE_FLAGS_DEFAULT);
       
   239 	return EAP_STATUS_RETURN(m_am_tools, send_status);
       
   240 }
       
   241 
       
   242 //--------------------------------------------------
       
   243 
       
   244 EAP_FUNC_EXPORT eap_status_e eap_general_settings_server_message_if_c::process_message_type_error(
       
   245 	EAP_TEMPLATE_CONST eap_array_c<eap_tlv_header_c> * const parameters)
       
   246 {
       
   247 	eap_status_e status(eap_status_ok);
       
   248 
       
   249 	eap_process_tlv_message_data_c message_data(m_am_tools);
       
   250 
       
   251 	if (message_data.get_is_valid() == false)
       
   252 	{
       
   253 		EAP_TRACE_END(m_am_tools, TRACE_FLAGS_DEFAULT);
       
   254 		return EAP_STATUS_RETURN(m_am_tools, eap_status_allocation_error);
       
   255 	}
       
   256 
       
   257 	// Error payload is the first in this case.
       
   258 	status = message_data.read_parameter_data(parameters, eap_message_payload_index_function, eap_tlv_message_type_error, &m_error_code);
       
   259 	if (status != eap_status_ok)
       
   260 	{
       
   261 		EAP_TRACE_END(m_am_tools, TRACE_FLAGS_DEFAULT);
       
   262 		return EAP_STATUS_RETURN(m_am_tools, status);
       
   263 	}
       
   264 
       
   265 	// Fuction payload is the second in this case.
       
   266 	status = message_data.read_parameter_data(parameters, eap_message_payload_index_first_parameter, &m_error_function);
       
   267 
       
   268 	EAP_TRACE_END(m_am_tools, TRACE_FLAGS_DEFAULT);
       
   269 	return EAP_STATUS_RETURN(m_am_tools, status);
       
   270 }
       
   271 
       
   272 //--------------------------------------------------
       
   273 
       
   274 EAP_FUNC_EXPORT eap_status_e eap_general_settings_server_message_if_c::process_message(eap_process_tlv_message_data_c * const message)
       
   275 {
       
   276 	// Parses message data composed of Attribute-Value Pairs.
       
   277 
       
   278 	EAP_TRACE_DATA_DEBUG(
       
   279 		m_am_tools,
       
   280 		EAP_TRACE_FLAGS_MESSAGE_DATA,
       
   281 		(EAPL("eap_general_settings_server_message_if_c::process_message()"),
       
   282 		message->get_message_data(),
       
   283 		message->get_message_data_length()));
       
   284 
       
   285 	EAP_TRACE_RETURN_STRING_FLAGS(m_am_tools, EAP_TRACE_FLAGS_MESSAGE_DATA, "returns: eap_general_settings_server_message_if_c::process_message()");
       
   286 
       
   287 	eap_array_c<eap_tlv_header_c> parameters(m_am_tools);
       
   288 
       
   289 	eap_status_e status = message->parse_message_data(&parameters);
       
   290 	if (status != eap_status_ok)
       
   291 	{
       
   292 		EAP_TRACE_END(m_am_tools, TRACE_FLAGS_DEFAULT);
       
   293 
       
   294 		(void) send_error_message(
       
   295 			status,
       
   296 			eap_tlv_message_type_function_none);
       
   297 
       
   298 		return EAP_STATUS_RETURN(m_am_tools, status);
       
   299 	}
       
   300 
       
   301 	if (parameters.get_object_count() == 0)
       
   302 	{
       
   303 		EAP_TRACE_END(m_am_tools, TRACE_FLAGS_DEFAULT);
       
   304 
       
   305 		status = eap_status_illegal_parameter;
       
   306 
       
   307 		(void) send_error_message(
       
   308 			status,
       
   309 			eap_tlv_message_type_function_none);
       
   310 
       
   311 		return EAP_STATUS_RETURN(m_am_tools, status);
       
   312 	}
       
   313 
       
   314 	const eap_tlv_header_c * const function_header = parameters.get_object(eap_message_payload_index_function);
       
   315 	if (function_header == 0
       
   316 		|| (function_header->get_type() != eap_tlv_message_type_error
       
   317 			&& function_header->get_type() != eap_tlv_message_type_function))
       
   318 	{
       
   319 		EAP_TRACE_END(m_am_tools, TRACE_FLAGS_DEFAULT);
       
   320 
       
   321 		status = eap_status_illegal_parameter;
       
   322 
       
   323 		(void) send_error_message(
       
   324 			status,
       
   325 			eap_tlv_message_type_function_none);
       
   326 
       
   327 		return EAP_STATUS_RETURN(m_am_tools, status);
       
   328 	}
       
   329 
       
   330 	if (function_header->get_type() == eap_tlv_message_type_error)
       
   331 	{
       
   332 		status = process_message_type_error(&parameters);
       
   333 	}
       
   334 	else // function_header->get_type() == eap_tlv_message_type_function
       
   335 	{
       
   336 		eap_tlv_message_type_function_e function(eap_tlv_message_type_function_none);
       
   337 
       
   338 		status = message->get_parameter_data(function_header, &function);
       
   339 		if (status != eap_status_ok)
       
   340 		{
       
   341 			EAP_TRACE_END(m_am_tools, TRACE_FLAGS_DEFAULT);
       
   342 
       
   343 			(void) send_error_message(
       
   344 				status,
       
   345 				eap_tlv_message_type_function_none);
       
   346 
       
   347 			return EAP_STATUS_RETURN(m_am_tools, status);
       
   348 		}
       
   349 
       
   350 		switch(function)
       
   351 		{
       
   352 		case eap_tlv_message_type_function_general_settings_set_eap_methods:
       
   353 			status = set_eap_methods(&parameters);
       
   354 			break;
       
   355 		case eap_tlv_message_type_function_general_settings_get_eap_methods:
       
   356 			status = get_eap_methods(&parameters);
       
   357 			break;
       
   358 		case eap_tlv_message_type_function_general_settings_get_certificate_lists:
       
   359 			status = get_certificate_lists(&parameters);
       
   360 			break;
       
   361 		case eap_tlv_message_type_function_general_settings_delete_all_eap_settings:
       
   362 			status = delete_all_eap_settings(&parameters);
       
   363 			break;
       
   364 		case eap_tlv_message_type_function_general_settings_copy_all_eap_settings:
       
   365 			status = copy_all_eap_settings(&parameters);
       
   366 			break;
       
   367 		default:
       
   368 			EAP_TRACE_ERROR(
       
   369 				m_am_tools,
       
   370 				TRACE_FLAGS_DEFAULT,
       
   371 				(EAPL("ERROR: process_data(): unknown function %d.\n"),
       
   372 				 function));
       
   373 
       
   374 			status = eap_status_illegal_parameter;
       
   375 
       
   376 			EAP_ASSERT_ANYWAY_TOOLS(m_am_tools);
       
   377 		};
       
   378 
       
   379 		if (status != eap_status_ok
       
   380 			&& status != eap_status_success
       
   381 			&& status != eap_status_pending_request
       
   382 			&& status != eap_status_completed_request
       
   383 			&& status != eap_status_drop_packet_quietly)
       
   384 		{
       
   385 			(void) send_error_message(
       
   386 				status,
       
   387 				function);
       
   388 		}
       
   389 	}
       
   390 
       
   391 	EAP_TRACE_END(m_am_tools, TRACE_FLAGS_DEFAULT);
       
   392 	return EAP_STATUS_RETURN(m_am_tools, status);
       
   393 }
       
   394 
       
   395 //--------------------------------------------------
       
   396 
       
   397 /// Function receives the data message from lower layer.
       
   398 /// Data is formatted to Attribute-Value Pairs.
       
   399 /// Look at eap_tlv_header_c and eap_tlv_message_data_c.
       
   400 EAP_FUNC_EXPORT eap_status_e eap_general_settings_server_message_if_c::process_data(const void * const data, const u32_t length)
       
   401 {
       
   402 	eap_status_e status(eap_status_process_general_error);
       
   403 
       
   404 	{
       
   405 		eap_process_tlv_message_data_c message(m_am_tools);
       
   406 
       
   407 		if (message.get_is_valid() == false)
       
   408 		{
       
   409 			EAP_TRACE_END(m_am_tools, TRACE_FLAGS_DEFAULT);
       
   410 
       
   411 			status = eap_status_allocation_error;
       
   412 
       
   413 			(void) send_error_message(
       
   414 				status,
       
   415 				eap_tlv_message_type_function_none);
       
   416 
       
   417 			return EAP_STATUS_RETURN(m_am_tools, status);
       
   418 		}
       
   419 
       
   420 		status = message.set_message_data(length, data);
       
   421 		if (status != eap_status_ok)
       
   422 		{
       
   423 			EAP_TRACE_END(m_am_tools, TRACE_FLAGS_DEFAULT);
       
   424 
       
   425 			(void) send_error_message(
       
   426 				status,
       
   427 				eap_tlv_message_type_function_none);
       
   428 
       
   429 			return EAP_STATUS_RETURN(m_am_tools, status);
       
   430 		}
       
   431 
       
   432 		status = process_message(&message);
       
   433 	}
       
   434 
       
   435 	EAP_TRACE_END(m_am_tools, TRACE_FLAGS_DEFAULT);
       
   436 	return EAP_STATUS_RETURN(m_am_tools, status);
       
   437 }
       
   438 
       
   439 //--------------------------------------------------
       
   440 
       
   441 //
       
   442 EAP_FUNC_EXPORT void eap_general_settings_server_message_if_c::set_is_valid()
       
   443 {
       
   444 	m_is_valid = true;
       
   445 }
       
   446 
       
   447 //--------------------------------------------------
       
   448 
       
   449 //
       
   450 EAP_FUNC_EXPORT bool eap_general_settings_server_message_if_c::get_is_valid()
       
   451 {
       
   452 	return m_is_valid;
       
   453 }
       
   454 
       
   455 //--------------------------------------------------
       
   456 
       
   457 //
       
   458 EAP_FUNC_EXPORT eap_status_e eap_general_settings_server_message_if_c::timer_expired(
       
   459 	const u32_t id, void *data)
       
   460 {
       
   461 	EAP_UNREFERENCED_PARAMETER(id);
       
   462 	EAP_UNREFERENCED_PARAMETER(data);
       
   463 	EAP_TRACE_BEGIN(m_am_tools, TRACE_FLAGS_DEFAULT);
       
   464 
       
   465 	EAP_TRACE_DEBUG(
       
   466 		m_am_tools,
       
   467 		EAP_TRACE_FLAGS_MESSAGE_DATA,
       
   468 		(EAPL("TIMER: %s: [0x%08x]->eap_general_settings_server_message_if_c::timer_expired(id 0x%02x, data 0x%08x).\n"),
       
   469 		 (m_is_client == true) ? "client": "server",
       
   470 		 this,
       
   471 		 id,
       
   472 		 data));
       
   473 
       
   474 	EAP_TRACE_RETURN_STRING_FLAGS(m_am_tools, EAP_TRACE_FLAGS_MESSAGE_DATA, "returns: eap_general_settings_server_message_if_c::timer_expired()");
       
   475 
       
   476 
       
   477 	return EAP_STATUS_RETURN(m_am_tools, eap_status_ok);
       
   478 }
       
   479 
       
   480 //--------------------------------------------------
       
   481 
       
   482 //
       
   483 EAP_FUNC_EXPORT eap_status_e eap_general_settings_server_message_if_c::timer_delete_data(
       
   484 	const u32_t id, void *data)
       
   485 {
       
   486 	EAP_UNREFERENCED_PARAMETER(id);
       
   487 	EAP_UNREFERENCED_PARAMETER(data);
       
   488 	EAP_TRACE_BEGIN(m_am_tools, TRACE_FLAGS_DEFAULT);
       
   489 
       
   490 	EAP_TRACE_DEBUG(
       
   491 		m_am_tools,
       
   492 		EAP_TRACE_FLAGS_MESSAGE_DATA,
       
   493 		(EAPL("TIMER: %s: [0x%08x]->eap_general_settings_server_message_if_c::timer_delete_data(id 0x%02x, data 0x%08x).\n"),
       
   494 		(m_is_client == true) ? "client": "server",
       
   495 		this, id, data));
       
   496 
       
   497 	EAP_TRACE_RETURN_STRING_FLAGS(m_am_tools, EAP_TRACE_FLAGS_MESSAGE_DATA, "returns: eap_general_settings_server_message_if_c::timer_delete_data()");
       
   498 
       
   499 	return EAP_STATUS_RETURN(m_am_tools, eap_status_ok);
       
   500 }
       
   501 
       
   502 //--------------------------------------------------
       
   503 
       
   504 eap_status_e eap_general_settings_server_message_if_c::set_eap_methods(
       
   505 	EAP_TEMPLATE_CONST eap_array_c<eap_tlv_header_c> * const parameters)
       
   506 {
       
   507 	EAP_TRACE_BEGIN(m_am_tools, TRACE_FLAGS_DEFAULT);
       
   508 
       
   509 	EAP_TRACE_DEBUG(
       
   510 		m_am_tools, 
       
   511 		EAP_TRACE_FLAGS_MESSAGE_DATA, 
       
   512 		(EAPL("%s: eap_general_settings_server_message_if_c::set_eap_methods()\n"),
       
   513 		 (m_is_client == true) ? "client": "server"));
       
   514 
       
   515 	EAP_TRACE_RETURN_STRING_FLAGS(m_am_tools, EAP_TRACE_FLAGS_MESSAGE_DATA, "returns: eap_general_settings_server_message_if_c::set_eap_methods()");
       
   516 
       
   517 	// - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
       
   518 
       
   519 	eap_status_e status(eap_status_ok);
       
   520 
       
   521 	u32_t parameter_index(eap_message_payload_index_first_parameter);
       
   522 
       
   523 	eap_process_tlv_message_data_c message_data(m_am_tools);
       
   524 
       
   525 	if (message_data.get_is_valid() == false)
       
   526 	{
       
   527 		EAP_TRACE_END(m_am_tools, TRACE_FLAGS_DEFAULT);
       
   528 		return EAP_STATUS_RETURN(m_am_tools, eap_status_allocation_error);
       
   529 	}
       
   530 
       
   531 	// - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
       
   532 
       
   533 	eap_method_settings_c internal_settings(m_am_tools);
       
   534 
       
   535 	status = message_data.read_parameter_data(parameters, parameter_index, &internal_settings);
       
   536 	if (status != eap_status_ok)
       
   537 	{
       
   538 		EAP_TRACE_END(m_am_tools, TRACE_FLAGS_DEFAULT);
       
   539 		return EAP_STATUS_RETURN(m_am_tools, status);
       
   540 	}
       
   541 
       
   542 	// - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
       
   543 
       
   544 	status = m_am_settings->set_eap_methods(
       
   545 		&internal_settings
       
   546 		);
       
   547 
       
   548 	// - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
       
   549 
       
   550 	EAP_TRACE_END(m_am_tools, TRACE_FLAGS_DEFAULT);
       
   551 	return EAP_STATUS_RETURN(m_am_tools, status);
       
   552 }
       
   553 
       
   554 //--------------------------------------------------
       
   555 
       
   556 eap_status_e eap_general_settings_server_message_if_c::get_eap_methods(
       
   557 	EAP_TEMPLATE_CONST eap_array_c<eap_tlv_header_c> * const parameters)
       
   558 {
       
   559 	EAP_TRACE_BEGIN(m_am_tools, TRACE_FLAGS_DEFAULT);
       
   560 
       
   561 	EAP_TRACE_DEBUG(
       
   562 		m_am_tools, 
       
   563 		EAP_TRACE_FLAGS_MESSAGE_DATA, 
       
   564 		(EAPL("%s: eap_general_settings_server_message_if_c::get_eap_methods()\n"),
       
   565 		 (m_is_client == true) ? "client": "server"));
       
   566 
       
   567 	EAP_TRACE_RETURN_STRING_FLAGS(m_am_tools, EAP_TRACE_FLAGS_MESSAGE_DATA, "returns: eap_general_settings_server_message_if_c::get_eap_methods()");
       
   568 
       
   569 	// - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
       
   570 
       
   571 	eap_status_e status(eap_status_ok);
       
   572 
       
   573 	u32_t parameter_index(eap_message_payload_index_first_parameter);
       
   574 
       
   575 	eap_process_tlv_message_data_c message_data(m_am_tools);
       
   576 
       
   577 	if (message_data.get_is_valid() == false)
       
   578 	{
       
   579 		EAP_TRACE_END(m_am_tools, TRACE_FLAGS_DEFAULT);
       
   580 		return EAP_STATUS_RETURN(m_am_tools, eap_status_allocation_error);
       
   581 	}
       
   582 
       
   583 	// - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
       
   584 
       
   585 	eap_method_settings_c internal_settings(m_am_tools);
       
   586 
       
   587 	status = message_data.read_parameter_data(parameters, parameter_index, &internal_settings);
       
   588 	if (status != eap_status_ok)
       
   589 	{
       
   590 		EAP_TRACE_END(m_am_tools, TRACE_FLAGS_DEFAULT);
       
   591 		return EAP_STATUS_RETURN(m_am_tools, status);
       
   592 	}
       
   593 
       
   594 	// - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
       
   595 
       
   596 	status = m_am_settings->get_eap_methods(
       
   597 		&internal_settings
       
   598 		);
       
   599 
       
   600 	// - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
       
   601 
       
   602 	EAP_TRACE_END(m_am_tools, TRACE_FLAGS_DEFAULT);
       
   603 	return EAP_STATUS_RETURN(m_am_tools, status);
       
   604 }
       
   605 
       
   606 //--------------------------------------------------
       
   607 
       
   608 eap_status_e eap_general_settings_server_message_if_c::get_certificate_lists(
       
   609 	EAP_TEMPLATE_CONST eap_array_c<eap_tlv_header_c> * const parameters)
       
   610 {
       
   611 	EAP_TRACE_BEGIN(m_am_tools, TRACE_FLAGS_DEFAULT);
       
   612 
       
   613 	EAP_TRACE_DEBUG(
       
   614 		m_am_tools, 
       
   615 		EAP_TRACE_FLAGS_MESSAGE_DATA, 
       
   616 		(EAPL("%s: eap_general_settings_server_message_if_c::get_certificate_lists()\n"),
       
   617 		 (m_is_client == true) ? "client": "server"));
       
   618 
       
   619 	EAP_TRACE_RETURN_STRING_FLAGS(m_am_tools, EAP_TRACE_FLAGS_MESSAGE_DATA, "returns: eap_general_settings_server_message_if_c::get_certificate_lists()");
       
   620 
       
   621 	// - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
       
   622 
       
   623 	eap_status_e status(eap_status_ok);
       
   624 
       
   625 	u32_t parameter_index(eap_message_payload_index_first_parameter);
       
   626 
       
   627 	eap_process_tlv_message_data_c message_data(m_am_tools);
       
   628 
       
   629 	if (message_data.get_is_valid() == false)
       
   630 	{
       
   631 		EAP_TRACE_END(m_am_tools, TRACE_FLAGS_DEFAULT);
       
   632 		return EAP_STATUS_RETURN(m_am_tools, eap_status_allocation_error);
       
   633 	}
       
   634 
       
   635 	// - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
       
   636 
       
   637 	eap_method_settings_c internal_settings(m_am_tools);
       
   638 
       
   639 	status = message_data.read_parameter_data(parameters, parameter_index, &internal_settings);
       
   640 	if (status != eap_status_ok)
       
   641 	{
       
   642 		EAP_TRACE_END(m_am_tools, TRACE_FLAGS_DEFAULT);
       
   643 		return EAP_STATUS_RETURN(m_am_tools, status);
       
   644 	}
       
   645 
       
   646 	// - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
       
   647 
       
   648 	status = m_am_settings->get_certificate_lists(
       
   649 		&internal_settings
       
   650 		);
       
   651 
       
   652 	// - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
       
   653 
       
   654 	EAP_TRACE_END(m_am_tools, TRACE_FLAGS_DEFAULT);
       
   655 	return EAP_STATUS_RETURN(m_am_tools, status);
       
   656 }
       
   657 
       
   658 //--------------------------------------------------
       
   659 
       
   660 eap_status_e eap_general_settings_server_message_if_c::delete_all_eap_settings(
       
   661 	EAP_TEMPLATE_CONST eap_array_c<eap_tlv_header_c> * const parameters)
       
   662 {
       
   663 	EAP_TRACE_BEGIN(m_am_tools, TRACE_FLAGS_DEFAULT);
       
   664 
       
   665 	EAP_TRACE_DEBUG(
       
   666 		m_am_tools, 
       
   667 		EAP_TRACE_FLAGS_MESSAGE_DATA, 
       
   668 		(EAPL("%s: eap_general_settings_server_message_if_c::get_certificate_lists()\n"),
       
   669 		 (m_is_client == true) ? "client": "server"));
       
   670 
       
   671 	EAP_TRACE_RETURN_STRING_FLAGS(m_am_tools, EAP_TRACE_FLAGS_MESSAGE_DATA, "returns: eap_general_settings_server_message_if_c::delete_all_eap_settings()");
       
   672 
       
   673 	// - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
       
   674 
       
   675 	eap_status_e status(eap_status_ok);
       
   676 
       
   677 	u32_t parameter_index(eap_message_payload_index_first_parameter);
       
   678 
       
   679 	eap_process_tlv_message_data_c message_data(m_am_tools);
       
   680 
       
   681 	if (message_data.get_is_valid() == false)
       
   682 	{
       
   683 		EAP_TRACE_END(m_am_tools, TRACE_FLAGS_DEFAULT);
       
   684 		return EAP_STATUS_RETURN(m_am_tools, eap_status_allocation_error);
       
   685 	}
       
   686 
       
   687 	// - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
       
   688 
       
   689 	eap_method_settings_c internal_settings(m_am_tools);
       
   690 
       
   691 	status = message_data.read_parameter_data(parameters, parameter_index, &internal_settings);
       
   692 	if (status != eap_status_ok)
       
   693 	{
       
   694 		EAP_TRACE_END(m_am_tools, TRACE_FLAGS_DEFAULT);
       
   695 		return EAP_STATUS_RETURN(m_am_tools, status);
       
   696 	}
       
   697 
       
   698 	// - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
       
   699 
       
   700 	status = m_am_settings->delete_all_eap_settings(
       
   701 		&internal_settings
       
   702 		);
       
   703 
       
   704 	// - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
       
   705 
       
   706 	EAP_TRACE_END(m_am_tools, TRACE_FLAGS_DEFAULT);
       
   707 	return EAP_STATUS_RETURN(m_am_tools, status);
       
   708 }
       
   709 
       
   710 //--------------------------------------------------
       
   711 
       
   712 eap_status_e eap_general_settings_server_message_if_c::copy_all_eap_settings(
       
   713 	EAP_TEMPLATE_CONST eap_array_c<eap_tlv_header_c> * const parameters)
       
   714 {
       
   715 	EAP_TRACE_BEGIN(m_am_tools, TRACE_FLAGS_DEFAULT);
       
   716 
       
   717 	EAP_TRACE_DEBUG(
       
   718 		m_am_tools, 
       
   719 		EAP_TRACE_FLAGS_MESSAGE_DATA, 
       
   720 		(EAPL("%s: eap_general_settings_server_message_if_c::get_certificate_lists()\n"),
       
   721 		 (m_is_client == true) ? "client": "server"));
       
   722 
       
   723 	EAP_TRACE_RETURN_STRING_FLAGS(m_am_tools, EAP_TRACE_FLAGS_MESSAGE_DATA, "returns: eap_general_settings_server_message_if_c::copy_all_eap_settings()");
       
   724 
       
   725 	// - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
       
   726 
       
   727 	eap_status_e status(eap_status_ok);
       
   728 
       
   729 	u32_t parameter_index(eap_message_payload_index_first_parameter);
       
   730 
       
   731 	eap_process_tlv_message_data_c message_data(m_am_tools);
       
   732 
       
   733 	if (message_data.get_is_valid() == false)
       
   734 	{
       
   735 		EAP_TRACE_END(m_am_tools, TRACE_FLAGS_DEFAULT);
       
   736 		return EAP_STATUS_RETURN(m_am_tools, eap_status_allocation_error);
       
   737 	}
       
   738 
       
   739 	// - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
       
   740 
       
   741 	eap_method_settings_c internal_settings(m_am_tools);
       
   742 
       
   743 	status = message_data.read_parameter_data(parameters, parameter_index, &internal_settings);
       
   744 	if (status != eap_status_ok)
       
   745 	{
       
   746 		EAP_TRACE_END(m_am_tools, TRACE_FLAGS_DEFAULT);
       
   747 		return EAP_STATUS_RETURN(m_am_tools, status);
       
   748 	}
       
   749 
       
   750 	// - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
       
   751 
       
   752 	status = m_am_settings->copy_all_eap_settings(
       
   753 		&internal_settings
       
   754 		);
       
   755 
       
   756 	// - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
       
   757 
       
   758 	EAP_TRACE_END(m_am_tools, TRACE_FLAGS_DEFAULT);
       
   759 	return EAP_STATUS_RETURN(m_am_tools, status);
       
   760 }
       
   761 
       
   762 //--------------------------------------------------
       
   763 
       
   764 EAP_FUNC_EXPORT eap_status_e eap_general_settings_server_message_if_c::complete_set_eap_methods(const eap_method_settings_c * const internal_settings)
       
   765 {
       
   766 	eap_status_e status(eap_status_process_general_error);
       
   767 
       
   768 	EAP_TRACE_DEBUG(
       
   769 		m_am_tools, 
       
   770 		EAP_TRACE_FLAGS_MESSAGE_DATA, 
       
   771 		(EAPL("%s: eap_core_server_message_if_c::complete_set_eap_methods()\n"),
       
   772 		 (m_is_client == true) ? "client": "server"));
       
   773 
       
   774 	EAP_TRACE_RETURN_STRING_FLAGS(m_am_tools, EAP_TRACE_FLAGS_MESSAGE_DATA, "returns: eap_core_server_message_if_c::complete_set_eap_methods()");
       
   775 
       
   776 	{
       
   777 		// Creates message data composed of Attribute-Value Pairs.
       
   778 		eap_process_tlv_message_data_c message(m_am_tools);
       
   779 
       
   780 		if (message.get_is_valid() == false)
       
   781 		{
       
   782 			EAP_TRACE_END(m_am_tools, TRACE_FLAGS_DEFAULT);
       
   783 			return EAP_STATUS_RETURN(m_am_tools, eap_status_allocation_error);
       
   784 		}
       
   785 
       
   786 		status = message.add_parameter_data(eap_tlv_message_type_function_general_settings_complete_set_eap_methods);
       
   787 		if (status != eap_status_ok)
       
   788 		{
       
   789 			EAP_TRACE_END(m_am_tools, TRACE_FLAGS_DEFAULT);
       
   790 			return EAP_STATUS_RETURN(m_am_tools, status);
       
   791 		}
       
   792 
       
   793 		status = message.add_parameter_data(internal_settings);
       
   794 		if (status != eap_status_ok)
       
   795 		{
       
   796 			EAP_TRACE_END(m_am_tools, TRACE_FLAGS_DEFAULT);
       
   797 			return EAP_STATUS_RETURN(m_am_tools, status);
       
   798 		}
       
   799 
       
   800 		status = send_message(&message);
       
   801 	}
       
   802 
       
   803 	EAP_TRACE_END(m_am_tools, TRACE_FLAGS_DEFAULT);
       
   804 	return EAP_STATUS_RETURN(m_am_tools, status);
       
   805 }
       
   806 
       
   807 //--------------------------------------------------
       
   808 
       
   809 EAP_FUNC_EXPORT eap_status_e eap_general_settings_server_message_if_c::complete_get_eap_methods(const eap_method_settings_c * const internal_settings)
       
   810 {
       
   811 	eap_status_e status(eap_status_process_general_error);
       
   812 
       
   813 	EAP_TRACE_DEBUG(
       
   814 		m_am_tools, 
       
   815 		EAP_TRACE_FLAGS_MESSAGE_DATA, 
       
   816 		(EAPL("%s: eap_core_server_message_if_c::complete_get_eap_methods()\n"),
       
   817 		 (m_is_client == true) ? "client": "server"));
       
   818 
       
   819 	EAP_TRACE_RETURN_STRING_FLAGS(m_am_tools, EAP_TRACE_FLAGS_MESSAGE_DATA, "returns: eap_core_server_message_if_c::complete_get_eap_methods()");
       
   820 
       
   821 	{
       
   822 		// Creates message data composed of Attribute-Value Pairs.
       
   823 		eap_process_tlv_message_data_c message(m_am_tools);
       
   824 
       
   825 		if (message.get_is_valid() == false)
       
   826 		{
       
   827 			EAP_TRACE_END(m_am_tools, TRACE_FLAGS_DEFAULT);
       
   828 			return EAP_STATUS_RETURN(m_am_tools, eap_status_allocation_error);
       
   829 		}
       
   830 
       
   831 		status = message.add_parameter_data(eap_tlv_message_type_function_general_settings_complete_get_eap_methods);
       
   832 		if (status != eap_status_ok)
       
   833 		{
       
   834 			EAP_TRACE_END(m_am_tools, TRACE_FLAGS_DEFAULT);
       
   835 			return EAP_STATUS_RETURN(m_am_tools, status);
       
   836 		}
       
   837 
       
   838 		status = message.add_parameter_data(internal_settings);
       
   839 		if (status != eap_status_ok)
       
   840 		{
       
   841 			EAP_TRACE_END(m_am_tools, TRACE_FLAGS_DEFAULT);
       
   842 			return EAP_STATUS_RETURN(m_am_tools, status);
       
   843 		}
       
   844 
       
   845 		status = send_message(&message);
       
   846 	}
       
   847 
       
   848 	EAP_TRACE_END(m_am_tools, TRACE_FLAGS_DEFAULT);
       
   849 	return EAP_STATUS_RETURN(m_am_tools, status);
       
   850 }
       
   851 
       
   852 //--------------------------------------------------
       
   853 
       
   854 EAP_FUNC_EXPORT eap_status_e eap_general_settings_server_message_if_c::complete_get_certificate_lists(const eap_method_settings_c * const internal_settings)
       
   855 {
       
   856 	eap_status_e status(eap_status_process_general_error);
       
   857 
       
   858 	EAP_TRACE_DEBUG(
       
   859 		m_am_tools, 
       
   860 		EAP_TRACE_FLAGS_MESSAGE_DATA, 
       
   861 		(EAPL("%s: eap_core_server_message_if_c::complete_get_certificate_lists()\n"),
       
   862 		 (m_is_client == true) ? "client": "server"));
       
   863 
       
   864 	EAP_TRACE_RETURN_STRING_FLAGS(m_am_tools, EAP_TRACE_FLAGS_MESSAGE_DATA, "returns: eap_core_server_message_if_c::complete_get_certificate_lists()");
       
   865 
       
   866 	{
       
   867 		// Creates message data composed of Attribute-Value Pairs.
       
   868 		eap_process_tlv_message_data_c message(m_am_tools);
       
   869 
       
   870 		if (message.get_is_valid() == false)
       
   871 		{
       
   872 			EAP_TRACE_END(m_am_tools, TRACE_FLAGS_DEFAULT);
       
   873 			return EAP_STATUS_RETURN(m_am_tools, eap_status_allocation_error);
       
   874 		}
       
   875 
       
   876 		status = message.add_parameter_data(eap_tlv_message_type_function_general_settings_complete_get_certificate_lists);
       
   877 		if (status != eap_status_ok)
       
   878 		{
       
   879 			EAP_TRACE_END(m_am_tools, TRACE_FLAGS_DEFAULT);
       
   880 			return EAP_STATUS_RETURN(m_am_tools, status);
       
   881 		}
       
   882 
       
   883 		status = message.add_parameter_data(internal_settings);
       
   884 		if (status != eap_status_ok)
       
   885 		{
       
   886 			EAP_TRACE_END(m_am_tools, TRACE_FLAGS_DEFAULT);
       
   887 			return EAP_STATUS_RETURN(m_am_tools, status);
       
   888 		}
       
   889 
       
   890 		status = send_message(&message);
       
   891 	}
       
   892 
       
   893 	EAP_TRACE_END(m_am_tools, TRACE_FLAGS_DEFAULT);
       
   894 	return EAP_STATUS_RETURN(m_am_tools, status);
       
   895 }
       
   896 
       
   897 //--------------------------------------------------
       
   898 
       
   899 EAP_FUNC_EXPORT eap_status_e eap_general_settings_server_message_if_c::complete_delete_all_eap_settings(const eap_method_settings_c * const internal_settings)
       
   900 {
       
   901 	eap_status_e status(eap_status_process_general_error);
       
   902 
       
   903 	EAP_TRACE_DEBUG(
       
   904 		m_am_tools, 
       
   905 		EAP_TRACE_FLAGS_MESSAGE_DATA, 
       
   906 		(EAPL("%s: eap_core_server_message_if_c::complete_delete_all_eap_settings()\n"),
       
   907 		 (m_is_client == true) ? "client": "server"));
       
   908 
       
   909 	EAP_TRACE_RETURN_STRING_FLAGS(m_am_tools, EAP_TRACE_FLAGS_MESSAGE_DATA, "returns: eap_core_server_message_if_c::complete_delete_all_eap_settings()");
       
   910 
       
   911 	{
       
   912 		// Creates message data composed of Attribute-Value Pairs.
       
   913 		eap_process_tlv_message_data_c message(m_am_tools);
       
   914 
       
   915 		if (message.get_is_valid() == false)
       
   916 		{
       
   917 			EAP_TRACE_END(m_am_tools, TRACE_FLAGS_DEFAULT);
       
   918 			return EAP_STATUS_RETURN(m_am_tools, eap_status_allocation_error);
       
   919 		}
       
   920 
       
   921 		status = message.add_parameter_data(eap_tlv_message_type_function_general_settings_complete_delete_all_eap_settings);
       
   922 		if (status != eap_status_ok)
       
   923 		{
       
   924 			EAP_TRACE_END(m_am_tools, TRACE_FLAGS_DEFAULT);
       
   925 			return EAP_STATUS_RETURN(m_am_tools, status);
       
   926 		}
       
   927 
       
   928 		status = message.add_parameter_data(internal_settings);
       
   929 		if (status != eap_status_ok)
       
   930 		{
       
   931 			EAP_TRACE_END(m_am_tools, TRACE_FLAGS_DEFAULT);
       
   932 			return EAP_STATUS_RETURN(m_am_tools, status);
       
   933 		}
       
   934 
       
   935 		status = send_message(&message);
       
   936 	}
       
   937 
       
   938 	EAP_TRACE_END(m_am_tools, TRACE_FLAGS_DEFAULT);
       
   939 	return EAP_STATUS_RETURN(m_am_tools, status);
       
   940 }
       
   941 
       
   942 //--------------------------------------------------
       
   943 
       
   944 EAP_FUNC_EXPORT eap_status_e eap_general_settings_server_message_if_c::complete_copy_all_eap_settings(const eap_method_settings_c * const internal_settings)
       
   945 {
       
   946 	eap_status_e status(eap_status_process_general_error);
       
   947 
       
   948 	EAP_TRACE_DEBUG(
       
   949 		m_am_tools, 
       
   950 		EAP_TRACE_FLAGS_MESSAGE_DATA, 
       
   951 		(EAPL("%s: eap_core_server_message_if_c::complete_copy_all_eap_settings()\n"),
       
   952 		 (m_is_client == true) ? "client": "server"));
       
   953 
       
   954 	EAP_TRACE_RETURN_STRING_FLAGS(m_am_tools, EAP_TRACE_FLAGS_MESSAGE_DATA, "returns: eap_core_server_message_if_c::complete_copy_all_eap_settings()");
       
   955 
       
   956 	{
       
   957 		// Creates message data composed of Attribute-Value Pairs.
       
   958 		eap_process_tlv_message_data_c message(m_am_tools);
       
   959 
       
   960 		if (message.get_is_valid() == false)
       
   961 		{
       
   962 			EAP_TRACE_END(m_am_tools, TRACE_FLAGS_DEFAULT);
       
   963 			return EAP_STATUS_RETURN(m_am_tools, eap_status_allocation_error);
       
   964 		}
       
   965 
       
   966 		status = message.add_parameter_data(eap_tlv_message_type_function_general_settings_complete_copy_all_eap_settings);
       
   967 		if (status != eap_status_ok)
       
   968 		{
       
   969 			EAP_TRACE_END(m_am_tools, TRACE_FLAGS_DEFAULT);
       
   970 			return EAP_STATUS_RETURN(m_am_tools, status);
       
   971 		}
       
   972 
       
   973 		status = message.add_parameter_data(internal_settings);
       
   974 		if (status != eap_status_ok)
       
   975 		{
       
   976 			EAP_TRACE_END(m_am_tools, TRACE_FLAGS_DEFAULT);
       
   977 			return EAP_STATUS_RETURN(m_am_tools, status);
       
   978 		}
       
   979 
       
   980 		status = send_message(&message);
       
   981 	}
       
   982 
       
   983 	EAP_TRACE_END(m_am_tools, TRACE_FLAGS_DEFAULT);
       
   984 	return EAP_STATUS_RETURN(m_am_tools, status);
       
   985 }
       
   986 
       
   987 //--------------------------------------------------
       
   988 // End.