Enterprise Security Library
Enterprise Security results/error codes

General Description

Enterprise Security library APIs return results of type cy_rslt_t and consist of three parts:

Result Format
                Module base                   Type    Library-specific error code
   +----------------------------------------+------+------------------------------+
   |CY_RSLT_MODULE_ENTERPRISE_SECURITY_BASE | 0x2  |           Error Code         |
   +----------------------------------------+------+------------------------------+
                    14 bits                  2 bits            16 bits

See the macro section of this document for library-specific error codes.

The data structure cy_rslt_t is part of cy_result.h located in <core_lib/include>

Module base: This base is derived from CY_RSLT_MODULE_MIDDLEWARE_BASE (defined in cy_result.h) and is an offset of the CY_RSLT_MODULE_MIDDLEWARE_BASE. The details of the offset and the middleware base are defined in cy_result_mw.h, which is part of the GitHub connectivity-utilities repo. For example, the Enterprise Security library uses CY_RSLT_MODULE_ENTERPRISE_SECURITY_BASE as the module base.

Type: This type is defined in cy_result.h and can be one of CY_RSLT_TYPE_FATAL, CY_RSLT_TYPE_ERROR, CY_RSLT_TYPE_WARNING, or CY_RSLT_TYPE_INFO.

Library-specific error code: These error codes are library-specific and defined in the macro section.

Helper macros used for creating the library-specific result are provided as part of cy_result.h.

Macros

#define CY_RSLT_ENTERPRISE_SECURITY_ERR_BASE   CY_RSLT_CREATE(CY_RSLT_TYPE_ERROR, CY_RSLT_MODULE_ENTERPRISE_SECURITY_BASE, 0)
 Enterprise Security base error code.
 
#define CY_RSLT_ENTERPRISE_SECURITY_ERROR   ( CY_RSLT_ENTERPRISE_SECURITY_ERR_BASE + 1 )
 Enterprise Security error codes. More...
 
#define CY_RSLT_ENTERPRISE_SECURITY_BADARG   ( CY_RSLT_ENTERPRISE_SECURITY_ERR_BASE + 2 )
 Bad argument. More...
 
#define CY_RSLT_ENTERPRISE_SECURITY_NOMEM   ( CY_RSLT_ENTERPRISE_SECURITY_ERR_BASE + 3 )
 Out of resources. More...
 
#define CY_RSLT_ENTERPRISE_SECURITY_TIMEOUT   ( CY_RSLT_ENTERPRISE_SECURITY_ERR_BASE + 4 )
 Out of resources. More...
 
#define CY_RSLT_ENTERPRISE_SECURITY_ALREADY_CONNECTED   ( CY_RSLT_ENTERPRISE_SECURITY_ERR_BASE + 5 )
 Already connected to AP. More...
 
#define CY_RSLT_ENTERPRISE_SECURITY_NOT_CONNECTED   ( CY_RSLT_ENTERPRISE_SECURITY_ERR_BASE + 6 )
 Not connected to any AP. More...
 
#define CY_RSLT_ENTERPRISE_SECURITY_JOIN_ERROR   ( CY_RSLT_ENTERPRISE_SECURITY_ERR_BASE + 7 )
 Error joining AP. More...
 
#define CY_RSLT_ENTERPRISE_SECURITY_LEAVE_ERROR   ( CY_RSLT_ENTERPRISE_SECURITY_ERR_BASE + 8 )
 Error leaving AP. More...
 
#define CY_RSLT_ENTERPRISE_SECURITY_TLS_ERROR   ( CY_RSLT_ENTERPRISE_SECURITY_ERR_BASE + 9 )
 TLS Error. More...
 
#define CY_RSLT_ENTERPRISE_SECURITY_SUPPLICANT_ERROR   ( CY_RSLT_ENTERPRISE_SECURITY_ERR_BASE + 10 )
 Supplicant error. More...
 
#define CY_RSLT_ENTERPRISE_SECURITY_SUPPLICANT_IN_PROGRESS   ( CY_RSLT_ENTERPRISE_SECURITY_ERR_BASE + 11 )
 Supplicant is in progress. More...
 
#define CY_RSLT_ENTERPRISE_SECURITY_SUPPLICANT_ABORTED   ( CY_RSLT_ENTERPRISE_SECURITY_ERR_BASE + 12 )
 Supplicant aborted. More...
 
#define CY_RSLT_ENTERPRISE_SECURITY_SUPPLICANT_NOT_STARTED   ( CY_RSLT_ENTERPRISE_SECURITY_ERR_BASE + 13 )
 Supplicant not yet started. More...
 
#define CY_RSLT_ENTERPRISE_SECURITY_SUPPLICANT_UNPROCESSED   ( CY_RSLT_ENTERPRISE_SECURITY_ERR_BASE + 14 )
 Unprocessed event. More...
 
#define CY_RSLT_ENTERPRISE_SECURITY_EAP_ERROR   ( CY_RSLT_ENTERPRISE_SECURITY_ERR_BASE + 15 )
 EAP error. More...
 

Macro Definition Documentation

◆ CY_RSLT_ENTERPRISE_SECURITY_ERROR

#define CY_RSLT_ENTERPRISE_SECURITY_ERROR   ( CY_RSLT_ENTERPRISE_SECURITY_ERR_BASE + 1 )

Enterprise Security error codes.

Generic error.

◆ CY_RSLT_ENTERPRISE_SECURITY_BADARG

#define CY_RSLT_ENTERPRISE_SECURITY_BADARG   ( CY_RSLT_ENTERPRISE_SECURITY_ERR_BASE + 2 )

Bad argument.

◆ CY_RSLT_ENTERPRISE_SECURITY_NOMEM

#define CY_RSLT_ENTERPRISE_SECURITY_NOMEM   ( CY_RSLT_ENTERPRISE_SECURITY_ERR_BASE + 3 )

Out of resources.

◆ CY_RSLT_ENTERPRISE_SECURITY_TIMEOUT

#define CY_RSLT_ENTERPRISE_SECURITY_TIMEOUT   ( CY_RSLT_ENTERPRISE_SECURITY_ERR_BASE + 4 )

Out of resources.

◆ CY_RSLT_ENTERPRISE_SECURITY_ALREADY_CONNECTED

#define CY_RSLT_ENTERPRISE_SECURITY_ALREADY_CONNECTED   ( CY_RSLT_ENTERPRISE_SECURITY_ERR_BASE + 5 )

Already connected to AP.

◆ CY_RSLT_ENTERPRISE_SECURITY_NOT_CONNECTED

#define CY_RSLT_ENTERPRISE_SECURITY_NOT_CONNECTED   ( CY_RSLT_ENTERPRISE_SECURITY_ERR_BASE + 6 )

Not connected to any AP.

◆ CY_RSLT_ENTERPRISE_SECURITY_JOIN_ERROR

#define CY_RSLT_ENTERPRISE_SECURITY_JOIN_ERROR   ( CY_RSLT_ENTERPRISE_SECURITY_ERR_BASE + 7 )

Error joining AP.

◆ CY_RSLT_ENTERPRISE_SECURITY_LEAVE_ERROR

#define CY_RSLT_ENTERPRISE_SECURITY_LEAVE_ERROR   ( CY_RSLT_ENTERPRISE_SECURITY_ERR_BASE + 8 )

Error leaving AP.

◆ CY_RSLT_ENTERPRISE_SECURITY_TLS_ERROR

#define CY_RSLT_ENTERPRISE_SECURITY_TLS_ERROR   ( CY_RSLT_ENTERPRISE_SECURITY_ERR_BASE + 9 )

TLS Error.

◆ CY_RSLT_ENTERPRISE_SECURITY_SUPPLICANT_ERROR

#define CY_RSLT_ENTERPRISE_SECURITY_SUPPLICANT_ERROR   ( CY_RSLT_ENTERPRISE_SECURITY_ERR_BASE + 10 )

Supplicant error.

◆ CY_RSLT_ENTERPRISE_SECURITY_SUPPLICANT_IN_PROGRESS

#define CY_RSLT_ENTERPRISE_SECURITY_SUPPLICANT_IN_PROGRESS   ( CY_RSLT_ENTERPRISE_SECURITY_ERR_BASE + 11 )

Supplicant is in progress.

◆ CY_RSLT_ENTERPRISE_SECURITY_SUPPLICANT_ABORTED

#define CY_RSLT_ENTERPRISE_SECURITY_SUPPLICANT_ABORTED   ( CY_RSLT_ENTERPRISE_SECURITY_ERR_BASE + 12 )

Supplicant aborted.

◆ CY_RSLT_ENTERPRISE_SECURITY_SUPPLICANT_NOT_STARTED

#define CY_RSLT_ENTERPRISE_SECURITY_SUPPLICANT_NOT_STARTED   ( CY_RSLT_ENTERPRISE_SECURITY_ERR_BASE + 13 )

Supplicant not yet started.

◆ CY_RSLT_ENTERPRISE_SECURITY_SUPPLICANT_UNPROCESSED

#define CY_RSLT_ENTERPRISE_SECURITY_SUPPLICANT_UNPROCESSED   ( CY_RSLT_ENTERPRISE_SECURITY_ERR_BASE + 14 )

Unprocessed event.

◆ CY_RSLT_ENTERPRISE_SECURITY_EAP_ERROR

#define CY_RSLT_ENTERPRISE_SECURITY_EAP_ERROR   ( CY_RSLT_ENTERPRISE_SECURITY_ERR_BASE + 15 )

EAP error.