Errors

## Errors Errors |

## Synopsis

    enum                MbimCoreError;
    enum                MbimProtocolError;
    enum                MbimStatusError;

    const gchar *       mbim_core_error_get_string          (MbimCoreError val);
    const gchar *       mbim_protocol_error_get_string      (MbimProtocolError val);
    const gchar *       mbim_status_error_get_string        (MbimStatusError val);

## Object Hierarchy

      GEnum
       +----MbimCoreError

      GEnum
       +----MbimProtocolError

      GEnum
       +----MbimStatusError

## Description

This section defines common error types used in the interface.

## Details

### enum MbimCoreError

    typedef enum {
     /*< underscore_name=mbim_core_error >*/
        MBIM_CORE_ERROR_FAILED           = 0, /*< nick=Failed >*/
        MBIM_CORE_ERROR_WRONG_STATE      = 1, /*< nick=WrongState >*/
        MBIM_CORE_ERROR_TIMEOUT          = 2, /*< nick=Timeout >*/
        MBIM_CORE_ERROR_INVALID_ARGS     = 3, /*< nick=InvalidArgs >*/
        MBIM_CORE_ERROR_INVALID_MESSAGE  = 4, /*< nick=InvalidMessage >*/
        MBIM_CORE_ERROR_UNSUPPORTED      = 5, /*< nick=Unsupported >*/
        MBIM_CORE_ERROR_ABORTED          = 6  /*< nick=Aborted >*/
    } MbimCoreError;

Common errors that may be reported by libmbim-glib.

`MBIM_CORE_ERROR_FAILED` | Operation failed.
`MBIM_CORE_ERROR_WRONG_STATE` | Operation cannot be executed in the current state.
`MBIM_CORE_ERROR_TIMEOUT` | Operation timed out.
`MBIM_CORE_ERROR_INVALID_ARGS` | Invalid arguments given.
`MBIM_CORE_ERROR_INVALID_MESSAGE` | MBIM message is invalid.
`MBIM_CORE_ERROR_UNSUPPORTED` | Not supported.
`MBIM_CORE_ERROR_ABORTED` | Operation aborted..

### enum MbimProtocolError

    typedef enum {
        MBIM_PROTOCOL_ERROR_INVALID                  = 0, /*< nick=Invalid >*/
        MBIM_PROTOCOL_ERROR_TIMEOUT_FRAGMENT         = 1, /*< nick=TimeoutFragment >*/
        MBIM_PROTOCOL_ERROR_FRAGMENT_OUT_OF_SEQUENCE = 2, /*< nick=FragmentOutOfSequence >*/
        MBIM_PROTOCOL_ERROR_LENGTH_MISMATCH          = 3, /*< nick=LengthMismatch >*/
        MBIM_PROTOCOL_ERROR_DUPLICATED_TID           = 4, /*< nick=DuplicatedTid >*/
        MBIM_PROTOCOL_ERROR_NOT_OPENED               = 5, /*< nick=NotOpened >*/
        MBIM_PROTOCOL_ERROR_UNKNOWN                  = 6, /*< nick=Unknown >*/
        MBIM_PROTOCOL_ERROR_CANCEL                   = 7, /*< nick=Cancel >*/
        MBIM_PROTOCOL_ERROR_MAX_TRANSFER             = 8  /*< nick=MaxTransfer >*/
    } MbimProtocolError;

MBIM protocol errors.

`MBIM_PROTOCOL_ERROR_INVALID` | Invalid MBIM error.
`MBIM_PROTOCOL_ERROR_TIMEOUT_FRAGMENT` | Timeout waiting for fragment.
`MBIM_PROTOCOL_ERROR_FRAGMENT_OUT_OF_SEQUENCE` | Fragment received out of sequence.
`MBIM_PROTOCOL_ERROR_LENGTH_MISMATCH` | Length mismatch.
`MBIM_PROTOCOL_ERROR_DUPLICATED_TID` | Duplicated transaction ID.
`MBIM_PROTOCOL_ERROR_NOT_OPENED` | Not opened.
`MBIM_PROTOCOL_ERROR_UNKNOWN` | Unknown error.
`MBIM_PROTOCOL_ERROR_CANCEL` | Cancel the operation.
`MBIM_PROTOCOL_ERROR_MAX_TRANSFER` | Maximum control transfer not supported.

### enum MbimStatusError

    typedef enum {
        MBIM_STATUS_ERROR_NONE                             = 0,  /*< nick=None >*/
        MBIM_STATUS_ERROR_BUSY                             = 1,  /*< nick=Busy >*/
        MBIM_STATUS_ERROR_FAILURE                          = 2,  /*< nick=Failure >*/
        MBIM_STATUS_ERROR_SIM_NOT_INSERTED                 = 3,  /*< nick=SimNotInserted >*/
        MBIM_STATUS_ERROR_BAD_SIM                          = 4,  /*< nick=BadSim >*/
        MBIM_STATUS_ERROR_PIN_REQUIRED                     = 5,  /*< nick=PinRequired >*/
        MBIM_STATUS_ERROR_PIN_DISABLED                     = 6,  /*< nick=PinDisabled >*/
        MBIM_STATUS_ERROR_NOT_REGISTERED                   = 7,  /*< nick=NotRegistered >*/
        MBIM_STATUS_ERROR_PROVIDERS_NOT_FOUND              = 8,  /*< nick=ProvidersNotFound >*/
        MBIM_STATUS_ERROR_NO_DEVICE_SUPPORT                = 9,  /*< nick=NoDeviceSupport >*/
        MBIM_STATUS_ERROR_PROVIDER_NOT_VISIBLE             = 10, /*< nick=ProviderNotVisible >*/
        MBIM_STATUS_ERROR_DATA_CLASS_NOT_AVAILABLE         = 11, /*< nick=DataClassNotAvailable >*/
        MBIM_STATUS_ERROR_PACKET_SERVICE_DETACHED          = 12, /*< nick=PacketServiceDetached >*/
        MBIM_STATUS_ERROR_MAX_ACTIVATED_CONTEXTS           = 13, /*< nick=MaxActivatedContexts >*/
        MBIM_STATUS_ERROR_NOT_INITIALIZED                  = 14, /*< nick=NotInitialized >*/
        MBIM_STATUS_ERROR_VOICE_CALL_IN_PROGRESS           = 15, /*< nick=VoiceCallInProgress >*/
        MBIM_STATUS_ERROR_CONTEXT_NOT_ACTIVATED            = 16, /*< nick=ContextNotActivated >*/
        MBIM_STATUS_ERROR_SERVICE_NOT_ACTIVATED            = 17, /*< nick=ServiceNotActivated >*/
        MBIM_STATUS_ERROR_INVALID_ACCESS_STRING            = 18, /*< nick=InvalidAccessString >*/
        MBIM_STATUS_ERROR_INVALID_USER_NAME_PWD            = 19, /*< nick=InvalidUserNamePwd >*/
        MBIM_STATUS_ERROR_RADIO_POWER_OFF                  = 20, /*< nick=RadioPowerOff >*/
        MBIM_STATUS_ERROR_INVALID_PARAMETERS               = 21, /*< nick=InvalidParameters >*/
        MBIM_STATUS_ERROR_READ_FAILURE                     = 22, /*< nick=ReadFailure >*/
        MBIM_STATUS_ERROR_WRITE_FAILURE                    = 23, /*< nick=WriteFailure >*/
        /* 24 = reserved */
        MBIM_STATUS_ERROR_NO_PHONEBOOK                     = 25, /*< nick=NoPhonebook >*/
        MBIM_STATUS_ERROR_PARAMETER_TOO_LONG               = 26, /*< nick=ParameterTooLong >*/
        MBIM_STATUS_ERROR_STK_BUSY                         = 27, /*< nick=StkBusy >*/
        MBIM_STATUS_ERROR_OPERATION_NOT_ALLOWED            = 28, /*< nick=OperationNotAllowed >*/
        MBIM_STATUS_ERROR_MEMORY_FAILURE                   = 29, /*< nick=MemoryFailure >*/
        MBIM_STATUS_ERROR_INVALID_MEMORY_INDEX             = 30, /*< nick=InvalidMemoryIndex >*/
        MBIM_STATUS_ERROR_MEMORY_FULL                      = 31, /*< nick=MemoryFull >*/
        MBIM_STATUS_ERROR_FILTER_NOT_SUPPORTED             = 32, /*< nick=FilterNotSupported >*/
        MBIM_STATUS_ERROR_DSS_INSTANCE_LIMIT               = 33, /*< nick=DssInstanceLimit >*/
        MBIM_STATUS_ERROR_INVALID_DEVICE_SERVICE_OPERATION = 34, /*< nick=InvalidDeviceServiceOperation >*/
        MBIM_STATUS_ERROR_AUTH_INCORRECT_AUTN              = 35, /*< nick=AuthIncorrectAuth >*/
        MBIM_STATUS_ERROR_AUTH_SYNC_FAILURE                = 36, /*< nick=AuthSyncFailure >*/
        MBIM_STATUS_ERROR_AUTH_AMF_NOT_SET                 = 37, /*< nick=AuthAmfNotSet >*/
        MBIM_STATUS_ERROR_SMS_UNKNOWN_SMSC_ADDRESS         = 100, /*< nick=SmsUnknownSmscAddress >*/
        MBIM_STATUS_ERROR_SMS_NETWORK_TIMEOUT              = 101, /*< nick=SmsNetworkTimeout >*/
        MBIM_STATUS_ERROR_SMS_LANG_NOT_SUPPORTED           = 102, /*< nick=SmsLangNotSupported >*/
        MBIM_STATUS_ERROR_SMS_ENCODING_NOT_SUPPORTED       = 103, /*< nick=SmsEncodingNotSupported >*/
        MBIM_STATUS_ERROR_SMS_FORMAT_NOT_SUPPORTED         = 104  /*< nick=SmsFormatNotSupported >*/
    } MbimStatusError;

Status of the MBIM request.

`MBIM_STATUS_ERROR_NONE` | Success, no error.
`MBIM_STATUS_ERROR_BUSY` | Busy.
`MBIM_STATUS_ERROR_FAILURE` | Failure.
`MBIM_STATUS_ERROR_SIM_NOT_INSERTED` | SIM not inserted.
`MBIM_STATUS_ERROR_BAD_SIM` | Bad SIM.
`MBIM_STATUS_ERROR_PIN_REQUIRED` | PIN required.
`MBIM_STATUS_ERROR_PIN_DISABLED` | PIN disabled.
`MBIM_STATUS_ERROR_NOT_REGISTERED` | Not registered.
`MBIM_STATUS_ERROR_PROVIDERS_NOT_FOUND` | Providers not found.
`MBIM_STATUS_ERROR_NO_DEVICE_SUPPORT` | No device support.
`MBIM_STATUS_ERROR_PROVIDER_NOT_VISIBLE` | Provider not visible.
`MBIM_STATUS_ERROR_DATA_CLASS_NOT_AVAILABLE` | Data class not available.
`MBIM_STATUS_ERROR_PACKET_SERVICE_DETACHED` | Packet service detached.
`MBIM_STATUS_ERROR_MAX_ACTIVATED_CONTEXTS` | Max activated contexts.
`MBIM_STATUS_ERROR_NOT_INITIALIZED` | Not initialized.
`MBIM_STATUS_ERROR_VOICE_CALL_IN_PROGRESS` | Voice call in progress.
`MBIM_STATUS_ERROR_CONTEXT_NOT_ACTIVATED` | Context not activated.
`MBIM_STATUS_ERROR_SERVICE_NOT_ACTIVATED` | Service not activated.
`MBIM_STATUS_ERROR_INVALID_ACCESS_STRING` | Invalid access string.
`MBIM_STATUS_ERROR_INVALID_USER_NAME_PWD` | Invalid user name or password.
`MBIM_STATUS_ERROR_RADIO_POWER_OFF` | Radio power off.
`MBIM_STATUS_ERROR_INVALID_PARAMETERS` | Invalid parameters.
`MBIM_STATUS_ERROR_READ_FAILURE` | Read failure.
`MBIM_STATUS_ERROR_WRITE_FAILURE` | Write failure.
`MBIM_STATUS_ERROR_NO_PHONEBOOK` | No phonebook.
`MBIM_STATUS_ERROR_PARAMETER_TOO_LONG` | Parameter too long.
`MBIM_STATUS_ERROR_STK_BUSY` | SIM toolkit busy.
`MBIM_STATUS_ERROR_OPERATION_NOT_ALLOWED` | Operation not allowed.
`MBIM_STATUS_ERROR_MEMORY_FAILURE` | Memory failure.
`MBIM_STATUS_ERROR_INVALID_MEMORY_INDEX` | Invalid memory index.
`MBIM_STATUS_ERROR_MEMORY_FULL` | Memory full.
`MBIM_STATUS_ERROR_FILTER_NOT_SUPPORTED` | Filter not supported.
`MBIM_STATUS_ERROR_DSS_INSTANCE_LIMIT` | DSS instance limit.
`MBIM_STATUS_ERROR_INVALID_DEVICE_SERVICE_OPERATION` | Invalid device service operation.
`MBIM_STATUS_ERROR_AUTH_INCORRECT_AUTN` | Incorrect AUTN when sending authentication.
`MBIM_STATUS_ERROR_AUTH_SYNC_FAILURE` | Synchronization failure during the authentication.
`MBIM_STATUS_ERROR_AUTH_AMF_NOT_SET` | AMF bit not set in the authentication.
`MBIM_STATUS_ERROR_SMS_UNKNOWN_SMSC_ADDRESS` | Unknown SMSC address.
`MBIM_STATUS_ERROR_SMS_NETWORK_TIMEOUT` | Network timeout when sending SMS.
`MBIM_STATUS_ERROR_SMS_LANG_NOT_SUPPORTED` | Language not supported in SMS.
`MBIM_STATUS_ERROR_SMS_ENCODING_NOT_SUPPORTED` | Encoding not supported in SMS.
`MBIM_STATUS_ERROR_SMS_FORMAT_NOT_SUPPORTED` | Format not supported in SMS.

### mbim_core_error_get_string ()

    const gchar *       mbim_core_error_get_string          (MbimCoreError val);

Gets the nickname string for the MbimCoreError specified at `val`.

`val` : | a MbimCoreError.
Returns : | a string with the nickname, or `NULL` if not found. Do not free the returned value. [transfer none]

### mbim_protocol_error_get_string ()

    const gchar *       mbim_protocol_error_get_string      (MbimProtocolError val);

Gets the nickname string for the MbimProtocolError specified at `val`.

`val` : | a MbimProtocolError.
Returns : | a string with the nickname, or `NULL` if not found. Do not free the returned value. [transfer none]

### mbim_status_error_get_string ()

    const gchar *       mbim_status_error_get_string        (MbimStatusError val);

Gets the nickname string for the MbimStatusError specified at `val`.

`val` : | a MbimStatusError.
Returns : | a string with the nickname, or `NULL` if not found. Do not free the returned value. [transfer none]