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]

			libmbim-glib Reference Manual
Top \| Description \| Object Hierarchy