qaGobiApiCbk.h File Reference

Callback Service API function prototypes. More...

Go to the source code of this file.

Data Structures

struct  BytesTotalDataType
struct  PacketsCountDataType
struct  SignalStrengthDataType
struct  SMSMTMessage
struct  SMSTransferRouteMTMessage
struct  SMSMessageMode
struct  SMSEtwsMessage
struct  SMSEtwsPlmn
struct  SMSCAddress
struct  SMSOnIMS
struct  SMSEventInfo_s
struct  CATEventDataType
struct  ServingSystemInfo
struct  SLQSSignalStrengthsInformation
struct  SLQSSignalStrengthsIndReq
struct  _transLayerInfoNotification
struct  _transNWRegInfoNotification
struct  omaDmFotaTlv
struct  omaDmConfigTlv
union  sessionInfo

Defines

#define SIGSTRENGTH_THRESHOLD_ARR_SZ   5
#define QMI_WMS_MAX_PAYLOAD_LENGTH   256
#define CBK_ENABLE_EVENT   0x01
#define CBK_DISABLE_EVENT   0x00
#define CBK_NOCHANGE   0xFF
#define MAX_RADIO_INTERFACE_LIST   255

Typedefs

typedef void(* tFNSessionState )(ULONG state, ULONG reconfiguration_required, ULONG sessionEndReason)
typedef void(* tFNDataBearer )(ULONG dataBearer)
typedef void(* tFNDormancyStatus )(ULONG dormancyStatus)
typedef void(* tFNPower )(ULONG operatingMode)
typedef void(* tFNByteTotals )(ULONGLONG totalBytesTX, ULONGLONG totalBytesRX)
typedef void(* tFNPacketsCount )(ULONG packetsCountTX, ULONG packetsCountRX)
typedef void(* tFNActivationStatus )(ULONG activationStatus)
typedef void(* tFNMobileIPStatus )(ULONG mipStatus)
typedef void(* tFNRoamingIndicator )(ULONG roaming)
typedef void(* tFNDataCapabilities )(BYTE dataCapsSize, BYTE *pDataCaps)
typedef void(* tFNSignalStrength )(INT8 signalStrength, ULONG radioInterface)
typedef void(* tFNRFInfo )(ULONG radioInterface, ULONG activeBandClass, ULONG activeChannel)
typedef void(* tFNLUReject )(ULONG serviceDomain, ULONG rejectCause)
typedef void(* tFNNewSMS )(ULONG storageType, ULONG messageIndex)
typedef enum SMSEventType eSMSEventType
typedef struct SMSMTMessage SMSMTMessageInfo
typedef struct
SMSTransferRouteMTMessage 
SMSTransferRouteMTMessageInfo
typedef struct SMSMessageMode SMSMessageModeInfo
typedef struct SMSEtwsMessage SMSEtwsMessageInfo
typedef struct SMSEtwsPlmn SMSEtwsPlmnInfo
typedef struct SMSCAddress SMSCAddressInfo
typedef struct SMSOnIMS SMSOnIMSInfo
typedef struct SMSEventInfo_s SMSEventInfo
typedef void(* tFNSMSEvents )(SMSEventInfo *pSMSEventInfo)
typedef void(* tFNNewNMEA )(LPCSTR pNMEA)
typedef void(* tFNPDSState )(ULONG enabledStatus, ULONG trackingStatus)
typedef void(* tFNCATEvent )(ULONG eventID, ULONG eventLen, BYTE *pEventData)
typedef enum device_state_enum eDevState
typedef void(* tFNDeviceStateChange )(eDevState device_state)
typedef void(* tFNFwDldCompletion )(ULONG fwdld_completion_status)
typedef void(* tFNSLQSOMADMAlert )(ULONG sessionType, BYTE *psessionTypeFields)
typedef void(* tFNOMADMState )(ULONG sessionState, ULONG failureReason)
typedef void(* tFNServingSystem )(struct ServingSystemInfo *pServingSystem)
typedef void(* tFNBandPreference )(ULONGLONG band_pref)
typedef void(* tFNUSSDRelease )(void)
typedef void(* tFNUSSDNotification )(ULONG type, BYTE *pNetworkInfo)
typedef void(* tFNSLQSSignalStrengths )(struct SLQSSignalStrengthsInformation sSLQSSignalStrengthsInfo)
typedef void(* tFNSDKTerminated )(BYTE *psReason)
typedef struct
_transLayerInfoNotification 
transLayerNotification
typedef void(* tFNtransLayerInfo )(transLayerNotification *pTransLayerNotification)
typedef struct
_transNWRegInfoNotification 
transNWRegInfoNotification
typedef void(* tFNtransNWRegInfo )(transNWRegInfoNotification *pTransNWRegInfoNotification)
typedef void(* tFNSysSelectionPref )(sysSelectPrefInfo *pSysSelectPrefInfo)
typedef union sessionInfo sessionInformation

Enumerations

enum  SMSEventType {
  SMS_EVENT_MT_MESSAGE = 0x01,
  SMS_EVENT_TRANSFER_ROUTE_MT_MESSAGE = 0x02,
  SMS_EVENT_MESSAGE_MODE = 0x04,
  SMS_EVENT_ETWS = 0x08,
  SMS_EVENT_ETWS_PLMN = 0x10,
  SMS_EVENT_SMSC_ADDRESS = 0x20,
  SMS_EVENT_SMS_ON_IMS = 0x40
}
enum  device_state_enum {
  DEVICE_STATE_DISCONNECTED,
  DEVICE_STATE_READY,
  DEVICE_STATE_BOOT
}

Functions

ULONG SetSessionStateCallback (tFNSessionState pCallback)
ULONG SetDataBearerCallback (tFNDataBearer pCallback)
ULONG SetDormancyStatusCallback (tFNDormancyStatus pCallback)
ULONG SetPowerCallback (tFNPower pCallback)
ULONG SetByteTotalsCallback (tFNByteTotals pCallback, BYTE interval)
ULONG iSetByteTotalsCallback (tFNByteTotals pCallback)
ULONG SetPacketsCountCallback (tFNPacketsCount pCallback, BYTE interval)
ULONG iSetPacketsCountCallback (tFNPacketsCount pCallback)
ULONG SetActivationStatusCallback (tFNActivationStatus pCallback)
ULONG SetMobileIPStatusCallback (tFNMobileIPStatus pCallback)
ULONG SetRoamingIndicatorCallback (tFNRoamingIndicator pCallback)
ULONG SetDataCapabilitiesCallback (tFNDataCapabilities pCallback)
ULONG SetSignalStrengthCallback (tFNSignalStrength pCallback, BYTE thresholdsSize, INT8 *pThresholds)
ULONG iSetSignalStrengthCallback (tFNSignalStrength pCallback)
ULONG SetRFInfoCallback (tFNRFInfo pCallback)
ULONG SetLURejectCallback (tFNLUReject pCallback)
ULONG SetNewSMSCallback (tFNNewSMS pCallback)
ULONG SLQSSetSMSEventCallback (tFNSMSEvents pCallback)
ULONG SetNMEACallback (tFNNewNMEA pCallback)
ULONG SetPDSStateCallback (tFNPDSState pCallback)
ULONG SetCATEventCallback (tFNCATEvent pCallback, ULONG eventMask, ULONG *pErrorMask)
ULONG iSetCATEventCallback (tFNCATEvent pCallback)
ULONG SetDeviceStateChangeCbk (tFNDeviceStateChange pCallback)
ULONG SetFwDldCompletionCbk (tFNFwDldCompletion pCallback)
ULONG SetSLQSOMADMAlertCallback (tFNSLQSOMADMAlert pCallback)
ULONG SetOMADMStateCallback (tFNOMADMState pCallback)
ULONG SLQSSetServingSystemCallback (tFNServingSystem pCallback)
ULONG SLQSSetBandPreferenceCbk (tFNBandPreference pCallback)
ULONG SetUSSDReleaseCallback (tFNUSSDRelease pCallback)
ULONG SetUSSDNotificationCallback (tFNUSSDNotification pCallback)
ULONG SLQSSetSignalStrengthsCallback (tFNSLQSSignalStrengths pCallback, struct SLQSSignalStrengthsIndReq *pSLQSSignalStrengthsIndReq)
ULONG iSLQSSetSignalStrengthsCallback (tFNSLQSSignalStrengths pCallback)
ULONG SLQSSetSDKTerminatedCallback (tFNSDKTerminated pCallback)
ULONG SLQSSetTransLayerInfoCallback (tFNtransLayerInfo pCallback)
ULONG SLQSSetTransNWRegInfoCallback (tFNtransNWRegInfo pCallback)
ULONG SLQSSetSysSelectionPrefCallBack (tFNSysSelectionPref pCallback)

Detailed Description

Callback Service API function prototypes.

Copyright: © 2011 Sierra Wireless, Inc. all rights reserved


Define Documentation

#define CBK_DISABLE_EVENT   0x00
#define CBK_ENABLE_EVENT   0x01
#define CBK_NOCHANGE   0xFF
#define MAX_RADIO_INTERFACE_LIST   255
#define QMI_WMS_MAX_PAYLOAD_LENGTH   256
#define SIGSTRENGTH_THRESHOLD_ARR_SZ   5

Typedef Documentation

Device State enumeration

This enumeration defines the different type of SMS events that are received

This union sessionInfo consist of omaDmFotaTlv and omaDmConfigTlv, out of which one will be unpacked against psessionTypeFields.

typedef struct SMSCAddress SMSCAddressInfo

This structure holds SMSC information

Parameters:
length 
  • Number of sets of following element
data 
  • SMSC address

This structure holds information related earthquake and Tsunami warning system

Parameters:
notificationType 
  • Message mode 0x00 - Primary 0x01 - Secondary GSM 0x02 - Secondary UMTS
length 
  • Number of sets of following elements
data 
  • Raw message data
typedef struct SMSEtwsPlmn SMSEtwsPlmnInfo

This structure holds information related ETWS PLMN

Parameters:
mobileCountryCode 
  • 16 bit representation of MCC value range : 0 -999
mobileNetworkCode 
  • 16 bit representation of MNC value range : 0 -999
typedef struct SMSEventInfo_s SMSEventInfo

This structure will hold the information related to received SMS events

Parameters:
smsEventType 
  • Type of the SMS events that are received. This is a bit map of SMSEventType. Only the parameters (which follows) related to the events received would be filled, and the rest of the parameters would be NULL
pMTMessageInfo 
  • pointer to the SMSMTMessageInfo structure
    NULL, if this event is not present in the smsEventType parameter
pTransferRouteMTMessageInfo 
pMessageModeInfo 
  • pointer to the SMSMessageModeInfo structure
    NULL, if this event is not present in the smsEventType parameter
pEtwsMessageInfo 
  • pointer to the SMSEtwsMessageInfo structure
    NULL, if this event is not present in the smsEventType parameter
pEtwsPlmnInfo 
  • pointer to the SMSEtwsPlmnInfo structure
    NULL, if this event is not present in the smsEventType parameter
pSMSCAddressInfo 
  • pointer to the SMSCAddressInfo structure
    NULL, if this event is not present in the smsEventType parameter
pSMSOnIMSInfo 
  • pointer to the SMSOnIMSInfo structure
    NULL, if this event is not present in the smsEventType parameter Note: None

This structure holds information related to message mode

Parameters:
messageMode 
  • Message mode 0x00 - CDMA 0x01 - GW

This structure holds information related to MT SMS

Parameters:
storageType 
  • SMS message storage type for the new message
    0 - UIM 1 - NV
messageIndex 
  • Index of the new message
typedef struct SMSOnIMS SMSOnIMSInfo

This structure holds information related to message mode

Parameters:
smsOnIMS 
  • Indicates whether the message is received from IMS 0x00 - Message is not recieved from IMS 0x01 - Message is recieved from IMS 0x02-0xFF - Reserved Note: In multiple modem solutions, this TLV may be used to help the client determine with which modem to communicate. This TLV may not be supported on all implementations.

This structure holds information related to transfer route MT SMS

Parameters:
ackIndicator 
  • Parameter to indicate if ACK must be sent by the control point 0x00 - Send ACK 0x01 - Do not send ACK
transactionID 
  • Transaction ID of the message
format 
  • Message format 0x00 - CDMA 0x02 - 0x05 - Reserved 0x06 - GW_PP 0x07 - GW_BC
length 
  • Length of the raw message. This length should not exceed the maximum WMS payload length of 256 bytes
data 
  • Raw message data
typedef void(* tFNActivationStatus)(ULONG activationStatus)

Activation status callback function.

Parameters:
activationStatus 
  • Service Activation Code
    • 0 - Service not activated
    • 1 - Service activated
    • 2 - Activation connecting
    • 3 - Activation connected
    • 4 - OTASP security authenticated
    • 5 - OTASP NAM downloaded
    • 6 - OTASP MDN downloaded
    • 7 - OTASP IMSI downloaded
    • 8 - OTASP PRL downloaded
    • 9 - OTASP SPC downloaded
    • 10 - OTASP settings committed
Note:
Technology Supported: CDMA
Device Supported: MC83x5
typedef void(* tFNBandPreference)(ULONGLONG band_pref)

Band Preference Callback function

Parameters:
pBandPref - Bit mask representing the current band preference Bit position meanings:

  • 0 - BC0_A - Band Class 0, A-System
  • 1 - BC0_B - Band Class 0, B-System, Band Class 0 AB , GSM 850 Band
  • 2 - BC1 - Band Class 1, all blocks
  • 3 - BC2 - Band Class 2 place holder
  • 4 - BC3 - Band Class 3, A-System
  • 5 - BC4 - Band Class 4, all blocks
  • 6 - BC5 - Band Class 5, all blocks
  • 7 - GSM_DCS_1800 - GSM DCS band
  • 8 - GSM_EGSM_900 - GSM Extended GSM (E-GSM) band
  • 9 - GSM_PGSM_900 - GSM Primary GSM (P-GSM) band
  • 10 - BC6 - Band Class 6
  • 11 - BC7 - Band Class 7
  • 12 - BC8 - Band Class 8
  • 13 - BC9 - Band Class 9
  • 14 - BC10 - Band Class 10
  • 15 - BC11 - Band Class 11
  • 16 - GSM_450 - GSM 450 band
  • 17 - GSM_480 - GSM 480 band
  • 18 - GSM_750 - GSM 750 band
  • 19 - GSM_850 - GSM 850 band
  • 20 - GSM_RGSM_900 - GSM Railways GSM Band
  • 21 - GSM_PCS_1900 - GSM PCS band
  • 22 - WCDMA_I_IMT_2000 - WCDMA EUROPE JAPAN and CHINA IMT 2100 band
  • 23 - WCDMA_II_PCS_1900 - WCDMA US PCS 1900 band
  • 24 - WCDMA_III_1700 - WCDMA EUROPE and CHINA DCS 1800 band
  • 25 - WCDMA_IV_1700 - WCDMA US 1700 band
  • 26 - WCDMA_V_850 - WCDMA US 850 band
  • 27 - WCDMA_VI_800 - WCDMA JAPAN 800 band
  • 28 - BC12 - Band Class 12
  • 29 - BC14 - Band Class 14
  • 30 - RESERVED_2 - Reserved 2
  • 31 - BC15 - Band Class 15
  • 32 - 47 - Reserved
  • 48 - WCDMA_VII_2600 - WCDMA EUROPE 2600 band
  • 49 - WCDMA_VIII_900 - WCDMA EUROPE and JAPAN 900 band
  • 50 - WCDMA_IX_1700 - WCDMA JAPAN 1700 band
  • 51 to 55 - Reserved
  • 56 - BBC16 - Band Class 16
  • 57 - BC17 - Band Class 17
  • 58 - BC18 - Band Class 18
  • 59 - BC19 - Band Class 19
  • 60 to 64 - Reserved
Note:
Technology Supported: UMTS/CDMA
Device Supported: MC83x5, MC7700/50
Timeout: NA To set the band preference the API SLQSSetBandPreference() should be used
typedef void(* tFNByteTotals)(ULONGLONG totalBytesTX, ULONGLONG totalBytesRX)

RX/TX byte counts callback function.

Parameters:
totalBytesTX 
  • Bytes transmitted without error
totalBytesRX 
  • Bytes received without error
Note:
Technology Supported: UMTS/CDMA
Device Supported: MC83x5, MC7700/50
typedef void(* tFNCATEvent)(ULONG eventID, ULONG eventLen, BYTE *pEventData)

CAT event callback function.

Parameters:
eventID 
  • Event ID
    • 16 - Display Text
    • 17 - Get In-Key
    • 18 - Get Input
    • 19 - Setup Menu
    • 20 - Select Item
    • 21 - Send SMS - Alpha Identifier
    • 22 - Setup Event List
    • 23 - Setup Idle Mode Text
    • 24 - Language Notification
    • 25 - Refresh
    • 26 - End Proactive Session
eventLen 
  • Length of pData (in bytes)
pEventData 
Note:
Technology Supported: UMTS
Device Supported: MC83x5
typedef void(* tFNDataBearer)(ULONG dataBearer)

Data bearer technology callback function.

Parameters:
dataBearer 
  • Data bearer technology
    • 0x00 - Indicates that this field is ignored
    • 0x01 - CDMA 1X
    • 0x02 - EV-DO Rev 0
    • 0x03 - GPRS
    • 0x04 - WCDMA
    • 0x05 - EV-DO Rev A
    • 0x06 - EDGE
    • 0x07 - HSDPA and WCDMA
    • 0x08 - WCDMA and HSUPA
    • 0x09 - HSDPA and HSUPA
    • 0x0A - LTE
    • 0x0B - EV-DO Rev A EHRPD
    • 0x0C - HSDPA+ and WCDMA
    • 0x0D - HSDPA+ and HSUPA
    • 0x0E - DC_HSDPA+ and WCDMA
    • 0x0F - DC_HSDPA+ and HSUPA
    • 0x8000 - NULL Bearer
    • 0xFF - Unknown Technology
Note:
Technology Supported: UMTS/CDMA
Device Supported: MC7700/50,MC83x5
typedef void(* tFNDataCapabilities)(BYTE dataCapsSize, BYTE *pDataCaps)

Serving system data capabilities callback function.

Parameters:
dataCapsSize 
  • Number of elements the data capability array contains
pDataCaps 
  • Data Capabilities Array.
    • 1 - GPRS
    • 2 - EDGE
    • 3 - HSDPA
    • 4 - HSUPA
    • 5 - WCDMA
    • 6 - CDMA 1xRTT
    • 7 - CDMA 1xEV-DO Rev 0
    • 8 - CDMA 1xEV-DO Rev. A
    • 9 - GSM
    • 10 - EVDO Rev. B
    • 11 - LTE
    • 12 - HSDPA Plus
    • 13 - Dual Carrier HSDPA Plus
Note:
Technology Supported: UMTS/CDMA
Device Supported: MC83x5, MC7700/50
typedef void(* tFNDeviceStateChange)(eDevState device_state)

Device State Change callback function prototype

Parameters:
device_state 
  • the current state of the device
Note:
Technology Supported: UMTS/CDMA
Device Supported: MC83x5, MC7700/50
Timeout: None
Does not require communication with the device
typedef void(* tFNDormancyStatus)(ULONG dormancyStatus)

Dormancy status callback function.

Parameters:
dormancyStatus 
  • Dormancy status
    • 1 - traffic channel dormant
    • 2 - traffic channel active
Note:
Technology Supported: UMTS/CDMA
Device Supported: MC83x5, MC7700/50
typedef void(* tFNFwDldCompletion)(ULONG fwdld_completion_status)

Firmware Download Completion callback function prototype

Parameters:
error_code 
  • error code returned from firmware download operation
Note:
Technology Supported: UMTS/CDMA
Device Supported: MC83x5, MC7700/50
Timeout: None
Does not require communication with the device
typedef void(* tFNLUReject)(ULONG serviceDomain, ULONG rejectCause)

LU reject callback function.

Parameters:
serviceDomain 
  • Service domain
    1 - Circuit Switched
rejectCause 
  • Reject cause
    See 3GPP TS 24.008, Section 4.4.4.7
Note:
Technology Supported: UMTS
Device Supported: None
typedef void(* tFNMobileIPStatus)(ULONG mipStatus)

Mobile IP status callback function.

Parameters:
mipStatus 
  • Mobile IP Status
    • 0 - success
    • All others error codes as defined in RFC 2002
Note:
Technology Supported: UMTS/CDMA
Device Supported: MC83x5
typedef void(* tFNNewNMEA)(LPCSTR pNMEA)

New NMEA sentence callback function.

Parameters:
pNMEA 
  • NULL-terminated string containing the position data in NMEA sentence format
Note:
Technology Supported: UMTS/CDMA
Device Supported: MC83x5
typedef void(* tFNNewSMS)(ULONG storageType, ULONG messageIndex)

New SMS message callback function.

Parameters:
storageType 
  • SMS message storage type for the new message
    0 - UIM 1 - NV
messageIndex 
  • Index of the new message
Note:
Technology Supported: UMTS/CDMA
Device Supported: MC83x5, MC7700/50
typedef void(* tFNOMADMState)(ULONG sessionState, ULONG failureReason)

OMA-DM state callback function

Parameters:
sessionState 
  • Session state
    • 0x00 - Complete, information was updated
    • 0x01 - Complete, update information is unavailable
    • 0x02 - Failed
    • 0x03 - Retrying
    • 0x04 - Connecting
    • 0x05 - Connected
    • 0x06 - Authenticated
    • 0x07 - Mobile Directory Number (MDN) downloaded
    • 0x08 - Mobile Station Identifier (MSID) downloaded
    • 0x09 - PRL downloaded
    • 0x0A - Mobile IP (MIP) profile downloaded
failureReason 
  • Session failure reason (when state indicates failure)
    • 0x00 - Unknown
    • 0x01 - Network is unavailable
    • 0x02 - Server is unavailable
    • 0x03 - Authentication failed
    • 0x04 - Maximum retry exceeded
    • 0x05 - Session is cancelled
Note:
Technology Supported: CDMA
Device Supported: MC83x5
typedef void(* tFNPacketsCount)(ULONG packetsCountTX, ULONG packetsCountRX)

RX/TX packets counts callback function.

Parameters:
packetsCountTX 
  • Packets transmitted without error
packetsCountRX 
  • Packets received without error
Note:
Technology Supported: UMTS/CDMA
Device Supported: MC83x5, MC7700/50
typedef void(* tFNPDSState)(ULONG enabledStatus, ULONG trackingStatus)

PDS session state callback function.

Parameters:
enabledStatus 
  • GPS enabled status
    • 0 - Disable
    • 1 - Enable
trackingStatus 
  • GPS tracking status
    • 0 - Unknown
    • 1 - Inactive
    • 2 - Active
Note:
Technology Supported: UMTS/CDMA
Device Supported: MC83x5
typedef void(* tFNPower)(ULONG operatingMode)

Power operating mode callback function.

Parameters:
operatingMode 
  • Service Operating mode
    See Tables for Operating Modes
Note:
Technology Supported: UMTS/CDMA
Device Supported: MC83x5, MC7700/50
typedef void(* tFNRFInfo)(ULONG radioInterface, ULONG activeBandClass, ULONG activeChannel)

RF information callback function.

Parameters:
radioInterface 
  • Radio interface technology of the signal being measured
    See Tables for Radio Interface
activeBandClass 
  • Active band class
    See Tables for Active Band Class
activeChannel 
  • Active channel
    • 0 - Channel is not relevant to the reported technology
Note:
Technology Supported: UMTS/CDMA
Device Supported: MC83x5, MC7700/50
typedef void(* tFNRoamingIndicator)(ULONG roaming)

Roaming indicator callback function.

Parameters:
roaming 
  • Roaming Indication
    • 0 - Roaming
    • 1 - Home
    • 2 - Roaming partner
    • >2 - Operator defined values
Note:
Technology Supported: UMTS/CDMA
Device Supported: MC83x5, MC7750
typedef void(* tFNSDKTerminated)(BYTE *psReason)

SDK terminated callback function prototype

Parameters:
psReason 
  • sdk termination reason string
Note:
Technology Supported: N/A
Device Supported: N/A
Timeout: None
Does not require communication with the device
typedef void(* tFNServingSystem)(struct ServingSystemInfo *pServingSystem)

Serving System callback function

Parameters:
pServingSystem 
Note:
Technology Supported: UMTS/CDMA/LTE
Device Supported: MC83x5,MC77xx
typedef void(* tFNSessionState)(ULONG state, ULONG reconfiguration_required, ULONG sessionEndReason)

Session state callback function.

Parameters:
state 
  • Current Link Status
    • 1 Disconnected
    • 2 Connected
    • 3 Suspended (Unsupported)
    • 4 Authenticating
reconfiguration_required 
  • Indicates if host needs to be reconfigured
    • 0 No need to reconfigure
    • 1 Reconfiguration required
sessionEndReason 
  • See Tables for Call End Reason
Note:
Technology Supported: UMTS/CDMA
Device Supported: MC83x5, MC7700/50
typedef void(* tFNSignalStrength)(INT8 signalStrength, ULONG radioInterface)

Signal strength callback function.

Parameters:
signalStrength 
  • Received signal strength (in dBm)
radioInterface 
  • Radio interface technology of the signal being measured
    See Tables for Radio Interface
Note:
Technology Supported: UMTS/CDMA
Device Supported: MC83x5, MC7700/50
typedef void(* tFNSLQSOMADMAlert)(ULONG sessionType, BYTE *psessionTypeFields)

SWIOMA-DM network-initiated alert callback function

Parameters:
sessionType 
  • 0x00 - SWIOMA-DM FOTA
  • 0x01 - SWIOMA-DM Config
psessionTypeFields 
  • Pointer to structure containing info for that sessionType
  • See sessionInfo for more details
Note:
Technology Supported: UMTS/CDMA
Device Supported: MC7750
typedef void(* tFNSLQSSignalStrengths)(struct SLQSSignalStrengthsInformation sSLQSSignalStrengthsInfo)

Received Signal Strength Information callback function.

Parameters:
sSLQSSignalStrengthsInfo 
Note:
Technology Supported: UMTS/CDMA
Device Supported: MC83x5, MC7700/71/50
typedef void(* tFNSMSEvents)(SMSEventInfo *pSMSEventInfo)

SMS event related callback function.

Parameters:
pSMSEventInfo[OUT] 
Note:
Technology Supported: UMTS/CDMA
Device Supported: MC7750,GOBI,MC7700
typedef void(* tFNSysSelectionPref)(sysSelectPrefInfo *pSysSelectPrefInfo)

System Selection Preference Callback function

Parameters:
pSysSelectPrefInfo 
  • Current System Selection preferences for the device.
  • See sysSelectPrefInfo for more information
Note:
Technology Supported: UMTS/CDMA
Device Supported: MC7700/10/50, MC83x5
typedef void(* tFNtransLayerInfo)(transLayerNotification *pTransLayerNotification)

Transport Layer Information callback.

Parameters:
transLayerNotification 
Note:
Technology Supported: UMTS/CDMA
Device Supported: MC7700/10/50
typedef void(* tFNtransNWRegInfo)(transNWRegInfoNotification *pTransNWRegInfoNotification)

Transport Network Registration Information callback.

Parameters:
pTransNWRegInfoNotification 
Note:
Technology Supported: UMTS/CDMA
Device Supported: MC7700/10/50
typedef void(* tFNUSSDNotification)(ULONG type, BYTE *pNetworkInfo)

SetUSSDNotificationCallback function prototype

Parameters:
type - Notification type

  • 0x01 - No action required
  • 0x02 - Action required
pNetworkInfo 
  • USS information from the network (0 indicates that no info was received)
Note:
Technology Supported: UMTS
Device Supported: MC83x5
typedef void(* tFNUSSDRelease)(void)

USSD releasecallback function prototype

Note:
Technology Supported: UMTS
Device Supported: MC83x5

Contains the parameters passed for SLQSSetTransLayerInfoCallback by the device.

Parameters:
regInd 
  • Indicates whether the transport layer is registered or not
  • Values:
    • 0x00 - Transport layer is not registered
    • 0x01 - Transport layer is registered
pTransLayerInfo 
Note:
None

Contains the parameters passed for SLQSSetTransNWRegInfoCallback by the device.

Parameters:
NWRegStat 
  • provides the transport network registration information
  • Values:
    • 0x00 - No Service
    • 0x01 - In Progress
    • 0x02 - Failed
    • 0x03 - Limited Service
    • 0x04 - Full Service
Note:
None

Enumeration Type Documentation

Device State enumeration

Enumerator:
DEVICE_STATE_DISCONNECTED 
DEVICE_STATE_READY 
DEVICE_STATE_BOOT 

This enumeration defines the different type of SMS events that are received

Enumerator:
SMS_EVENT_MT_MESSAGE 
SMS_EVENT_TRANSFER_ROUTE_MT_MESSAGE 
SMS_EVENT_MESSAGE_MODE 
SMS_EVENT_ETWS 
SMS_EVENT_ETWS_PLMN 
SMS_EVENT_SMSC_ADDRESS 
SMS_EVENT_SMS_ON_IMS 

Function Documentation

ULONG iSetByteTotalsCallback ( tFNByteTotals  pCallback  ) 
ULONG iSetCATEventCallback ( tFNCATEvent  pCallback  ) 
ULONG iSetPacketsCountCallback ( tFNPacketsCount  pCallback  ) 
ULONG iSetSignalStrengthCallback ( tFNSignalStrength  pCallback  ) 
ULONG iSLQSSetSignalStrengthsCallback ( tFNSLQSSignalStrengths  pCallback  ) 
ULONG SetActivationStatusCallback ( tFNActivationStatus  pCallback  ) 

Enables/disables the Activation Status callback function. The most recent successfully subscribed callback function will be the only function that is invoked when the corresponding event occurs.

Parameters:
pCallback[IN] 
  • Callback function pointer (0 - disable)
Returns:
eQCWWAN_ERR_NONE on success, eQCWWAN_xxx error value otherwise
See also:
See qmerrno.h for eQCWWAN_xxx error values
Note:
Technology Supported: CDMA
Device Supported: MC83x5
Timeout: 2 seconds
ULONG SetByteTotalsCallback ( tFNByteTotals  pCallback,
BYTE  interval 
)

Enables/disables the Byte Totals callback function. The most recent successfully subscribed callback function will be the only function that is invoked when the corresponding event occurs. This function cannot be used with function SetPacketsCountCallback in the same time. It means that this callback function (if it is already set) need to be cleared when you want to SetPacketsCountCallback and vice versa.

Parameters:
pCallback[IN] 
  • Callback function pointer (0 - disable)
interval 
  • Interval in seconds.
  • ignored when disabling, should be non-zero when enabling
Returns:
eQCWWAN_ERR_NONE on success, eQCWWAN_xxx error value otherwise
See also:
See qmerrno.h for eQCWWAN_xxx error values
Note:
Technology Supported: UMTS/CDMA
Device Supported: MC83x5, MC7700/50
Timeout: 2 seconds
ULONG SetCATEventCallback ( tFNCATEvent  pCallback,
ULONG  eventMask,
ULONG pErrorMask 
)

Enables/disables the CAT event callback function. The most recent successfully subscribed callback function will be the only function that is invoked when the corresponding event occurs.

Parameters:
pCallback[IN] 
  • Callback function pointer (0 - Disable)
eventMask 
  • bitmask of CAT events to register for
    • 0x00000001 - Display Text
    • 0x00000002 - Get In-Key
    • 0x00000004 - Get Input
    • 0x00000008 - Setup Menu
    • 0x00000010 - Select Item
    • 0x00000020 - Send SMS - Alpha Identifier
    • 0x00000040 - Setup Event: User Activity
    • 0x00000080 - Setup Event: Idle Screen Notify
    • 0x00000100 - Setup Event: Language Sel Notify
    • 0x00000200 - Setup Idle Mode Text
    • 0x00000400 - Language Notification
    • 0x00000800 - Refresh
    • 0x00001000 - End Proactive Session
pErrorMask[OUT] 
  • error bitmask. Each bit set indicates the proactive command that caused the error
    • 0x00000001 - Display Text
    • 0x00000002 - Get In-Key
    • 0x00000004 - Get Input
    • 0x00000008 - Setup Menu
    • 0x00000010 - Select Item
    • 0x00000020 - Send SMS - Alpha Identifier
    • 0x00000040 - Setup Event: User Activity
    • 0x00000080 - Setup Event: Idle Screen Notify
    • 0x00000100 - Setup Event: Language Sel Notify
    • 0x00000200 - Setup Idle Mode Text
    • 0x00000400 - Language Notification
    • 0x00000800 - Refresh
    • 0x00001000 - End Proactive Session
Returns:
eQCWWAN_ERR_NONE on success, eQCWWAN_xxx error value otherwise
Note:
Technology Supported: UMTS
Device Supported: MC83x5
Timeout: 2 seconds
ULONG SetDataBearerCallback ( tFNDataBearer  pCallback  ) 

Enables/disables the Data Bearer state callback function. The most recent successfully subscribed callback function will be the only function that is invoked when the corresponding event occurs.

Parameters:
pCallback[IN] 
  • Callback function pointer (0 - disable)
Returns:
eQCWWAN_ERR_NONE on success, eQCWWAN_xxx error value otherwise
See also:
See qmerrno.h for eQCWWAN_xxx error values
Note:
Technology Supported: UMTS/CDMA
Device Supported: MC7700/50,MC83x5
Timeout: 2 seconds
ULONG SetDataCapabilitiesCallback ( tFNDataCapabilities  pCallback  ) 

Enables/disables the data capabilities callback function. The most recent successfully subscribed callback function will be the only function that is invoked when the corresponding event occurs.

Parameters:
pCallback[IN] 
  • Callback function pointer (0 - disable)
Returns:
eQCWWAN_ERR_NONE on success, eQCWWAN_xxx error value otherwise
See also:
See qmerrno.h for eQCWWAN_xxx error values
Note:
Technology Supported: UMTS/CDMA
Device Supported: MC83x5, MC7700/50
Timeout: None
Does not require communication with the device
ULONG SetDeviceStateChangeCbk ( tFNDeviceStateChange  pCallback  ) 

Used by the client application to register a Callback function for Device State Change (DSC) event notifications. The most recent successfully subscribed callback function will be the only function that is invoked when the corresponding event occurs.

Parameters:
pCallback[IN] 
  • a valid function pointer to be notified of DSC events
  • NULL to disable DSC event notification
Returns:
eQCWWAN_ERR_NONE on success, eQCWWAN_xxx error value otherwise
See also:
See qmerrno.h for eQCWWAN_xxx error values
Note:
Technology Supported: UMTS
Device Supported: MC83x5, MC7700/50
Timeout: N/A
ULONG SetDormancyStatusCallback ( tFNDormancyStatus  pCallback  ) 

Enables/disables the Dormancy Status callback function. The most recent successfully subscribed callback function will be the only function that is invoked when the corresponding event occurs.

Parameters:
pCallback[IN] 
  • Callback function pointer (0 - disable)
Returns:
eQCWWAN_ERR_NONE on success, eQCWWAN_xxx error value otherwise
See also:
See qmerrno.h for eQCWWAN_xxx error values
Note:
Technology Supported: UMTS/CDMA
Device Supported: MC83x5, MC7700/50
Timeout: 2 seconds
ULONG SetFwDldCompletionCbk ( tFNFwDldCompletion  pCallback  ) 

Used by the client application to register a Callback function for a Firmware Download Completion (FDC) event notification. The most recent successfully subscribed callback function will be the only function that is invoked when the corresponding event occurs.

Parameters:
pCallback[IN] 
  • a valid function pointer to enable FDC event notification
  • NULL to disable FDC event notification
Returns:
eQCWWAN_ERR_NONE on success, eQCWWAN_xxx error value otherwise
See also:
See qmerrno.h for eQCWWAN_xxx error values
Note:
Technology Supported: UMTS/CDMA
Device Supported: MC83x5, MC7700/50
Timeout: N/A
ULONG SetLURejectCallback ( tFNLUReject  pCallback  ) 

Enables/disables the LU reject callback function. The most recent successfully subscribed callback function will be the only function that is invoked when the corresponding event occurs.

Parameters:
pCallback[IN] 
  • Callback function pointer (0 - disable)
Returns:
eQCWWAN_ERR_NONE on success, eQCWWAN_xxx error value otherwise
See also:
See qmerrno.h for eQCWWAN_xxx error values
Note:
Technology Supported: UMTS/CDMA
Device Supported: None
Timeout: 2 seconds
ULONG SetMobileIPStatusCallback ( tFNMobileIPStatus  pCallback  ) 

Enables/disables the Mobile IP Status callback function. The most recent successfully subscribed callback function will be the only function that is invoked when the corresponding event occurs.

Parameters:
pCallback[IN] 
  • Callback function pointer (0 - disable)
Returns:
eQCWWAN_ERR_NONE on success, eQCWWAN_xxx error value otherwise
See also:
See qmerrno.h for eQCWWAN_xxx error values
Note:
Technology Supported: CDMA
Device Supported: MC83x5
Timeout: 2 seconds
ULONG SetNewSMSCallback ( tFNNewSMS  pCallback  ) 

Enables/disables the new SMS callback function. The most recent successfully subscribed callback function will be the only function that is invoked when the corresponding event occurs.

Parameters:
pCallback[IN] 
  • Callback function pointer (0 - Disable)
Returns:
eQCWWAN_ERR_NONE on success, eQCWWAN_xxx error value otherwise
Note:
Technology Supported: UMTS/CDMA
Device Supported: MC83x5, MC7700/50
Timeout: 2 seconds
ULONG SetNMEACallback ( tFNNewNMEA  pCallback  ) 

Enables/disables the NMEA sentence callback function. The most recent successfully subscribed callback function will be the only function that is invoked when the corresponding event occurs.

Parameters:
pCallback[IN] 
  • Callback function pointer (0 - Disable)
Returns:
eQCWWAN_ERR_NONE on success, eQCWWAN_xxx error value otherwise
Note:
Technology Supported: UMTS/CDMA
Device Supported: MC83x5
Timeout: 2 seconds
ULONG SetOMADMStateCallback ( tFNOMADMState  pCallback  ) 

Enables/disables the OMADM state callback function. The most recent successfully subscribed callback function will be the only function that is invoked when the corresponding event occurs.

Parameters:
pCallback[IN] 
  • a valid function pointer to enable OMADMState notification
  • NULL to disable OMADMState notification
Returns:
eQCWWAN_ERR_NONE on success, eQCWWAN_xxx error value otherwise
Note:
Technology Supported: CDMA
Device Supported: MC83x5
Timeout: 2 seconds
ULONG SetPacketsCountCallback ( tFNPacketsCount  pCallback,
BYTE  interval 
)

Enables/disables the Packets Count callback function. The most recent successfully subscribed callback function will be the only function that is invoked when the corresponding event occurs. This function cannot be used with function SetByteTotalsCallback in the same time. It means that this callback function (if it is already set) need to be cleared when you want to SetByteTotalsCallback and vice versa.

Parameters:
pCallback[IN] 
  • Callback function pointer (0 - disable)
interval 
  • Interval in seconds.
  • ignored when disabling, should be non-zero when enabling
Returns:
eQCWWAN_ERR_NONE on success, eQCWWAN_xxx error value otherwise
See also:
See qmerrno.h for eQCWWAN_xxx error values
Note:
Technology Supported: UMTS/CDMA
Device Supported: MC83x5, MC7700/50
Timeout: 2 seconds
ULONG SetPDSStateCallback ( tFNPDSState  pCallback  ) 

Enables/disables the PDS service state callback function. The most recent successfully subscribed callback function will be the only function that is invoked when the corresponding event occurs.

Parameters:
pCallback[IN] 
  • Callback function pointer (0 - Disable)
Returns:
eQCWWAN_ERR_NONE on success, eQCWWAN_xxx error value otherwise
Note:
Technology Supported: UMTS/CDMA
Device Supported: MC83x5
Timeout: 2 seconds
ULONG SetPowerCallback ( tFNPower  pCallback  ) 

Enables/disables the Operating Mode callback function. The most recent successfully subscribed callback function will be the only function that is invoked when the corresponding event occurs.

Parameters:
pCallback[IN] 
  • Callback function pointer (0 - disable)
Returns:
eQCWWAN_ERR_NONE on success, eQCWWAN_xxx error value otherwise
See also:
See qmerrno.h for eQCWWAN_xxx error values
Note:
Technology Supported: UMTS/CDMA
Device Supported: MC83x5, MC7700/50
Timeout: 2 seconds
ULONG SetRFInfoCallback ( tFNRFInfo  pCallback  ) 

Enables/disables the radio frequency information callback function. The most recent successfully subscribed callback function will be the only function that is invoked when the corresponding event occurs.

Parameters:
pCallback[IN] 
  • Callback function pointer (0 - Disable)
Returns:
eQCWWAN_ERR_NONE on success, eQCWWAN_xxx error value otherwise
See also:
See qmerrno.h for eQCWWAN_xxx error values
Note:
Technology Supported: UMTS/CDMA
Device Supported: MC83x5, MC7700/50
Timeout: 2 seconds
ULONG SetRoamingIndicatorCallback ( tFNRoamingIndicator  pCallback  ) 

Enables/disables the Roaming Indicator callback function. The most recent successfully subscribed callback function will be the only function that is invoked when the corresponding event occurs.

Parameters:
pCallback[IN] 
  • Callback function pointer (0 - disable)
Returns:
eQCWWAN_ERR_NONE on success, eQCWWAN_xxx error value otherwise
See also:
See qmerrno.h for eQCWWAN_xxx error values
Note:
Technology Supported: UMTS/CDMA
Device Supported: MC83x5, MC7750
Timeout: 2 seconds
ULONG SetSessionStateCallback ( tFNSessionState  pCallback  ) 

Enables/disables the session state callback function. The most recent successfully subscribed callback function will be the only function that is invoked when the corresponding event occurs.

Parameters:
pCallback[IN] 
  • Callback function pointer (0 - disable)
Returns:
eQCWWAN_ERR_NONE on success, eQCWWAN_xxx error value otherwise
See also:
See qmerrno.h for eQCWWAN_xxx error values
Note:
Technology Supported: UMTS/CDMA
Device Supported: MC83x5, MC7700/50
Timeout: none; does not require communication with the device
ULONG SetSignalStrengthCallback ( tFNSignalStrength  pCallback,
BYTE  thresholdsSize,
INT8 pThresholds 
)

Enables/disables the Signal Strength callback function. The most recent successfully subscribed callback function will be the only function that is invoked when the corresponding event occurs.

Parameters:
pCallback[IN] 
  • Callback function pointer (0-Disable)
thresholdsSize 
  • Number of elements threshold array contains; a maximum of five thresholds is supported;
  • This parameter is not used when disabling the callback.
pThresholds[IN] 
  • Signal threshold array for each entry (in dBm).
  • This parameter is not used when disabling the callback.
Returns:
eQCWWAN_ERR_NONE on success, eQCWWAN_xxx error value otherwise
See also:
See qmerrno.h for eQCWWAN_xxx error values
Note:
Technology Supported: UMTS/CDMA
Device Supported: MC83x5, MC7700/50
Timeout: 2 seconds
The signal strength callback function is called when a threshold in the threshold array is crossed.
ULONG SetSLQSOMADMAlertCallback ( tFNSLQSOMADMAlert  pCallback  ) 

Enables/disables the SWIOMADM network-initiated alert callback function. The most recent successfully subscribed callback function will be the only function that is invoked when the corresponding event occurs.

Parameters:
pCallback[IN] 
  • a valid function pointer to enable SLQSOMADMAlert notification
  • NULL to disable SLQSOMADMAlert notification
Returns:
eQCWWAN_ERR_NONE on success, eQCWWAN_xxx error value otherwise
Note:
Technology Supported: UMTS/CDMA
Device Supported: MC7750
Timeout: 2 seconds
ULONG SetUSSDNotificationCallback ( tFNUSSDNotification  pCallback  ) 

Enables/disables the USSDNotification callback function. The most recent successfully subscribed callback function will be the only function that is invoked when the corresponding event occurs.

Parameters:
pCallback[IN] 
  • a valid function pointer to enable ServingSystem notification
  • NULL to disable ServingSystem notification
Returns:
eQCWWAN_ERR_NONE on success, eQCWWAN_xxx error value otherwise
Note:
Technology Supported: UMTS
Device Supported: MC83x5
Timeout: Does not require communication with device
ULONG SetUSSDReleaseCallback ( tFNUSSDRelease  pCallback  ) 

Enables/disables the USSD release callback function. The most recent successfully subscribed callback function will be the only function that is invoked when the corresponding event occurs.

Parameters:
pCallback[IN] 
  • a valid function pointer to enable ServingSystem notification
  • NULL to disable ServingSystem notification
Returns:
eQCWWAN_ERR_NONE on success, eQCWWAN_xxx error value otherwise
Note:
Technology Supported: UMTS
Device Supported: MC83x5
Timeout: Does not require communication with the device
ULONG SLQSSetBandPreferenceCbk ( tFNBandPreference  pCallback  ) 

Enables/disables the Band Preference callback function. The most recent successfully subscribed callback function will be the only function that is invoked when the corresponding event occurs.

Parameters:
pCallback[IN] 
  • a valid function pointer to enable Band Preference Indication notification
  • NULL to disable Band Preference notification
Returns:
eQCWWAN_ERR_NONE on success, eQCWWAN_xxx error value otherwise
Note:
Technology Supported: UMTS/CDMA
Device Supported: MC83x5, MC7700/50
Timeout: NA To set the band preference the API SLQSSetBandPreference() should be used
ULONG SLQSSetSDKTerminatedCallback ( tFNSDKTerminated  pCallback  ) 

Used by the client application to register a Callback function for SDK terminated event notifications. The most recent successfully subscribed callback function will be the only function that is invoked when the corresponding event occurs.

Parameters:
pCallback[IN] 
  • a valid function pointer to be notified of SWI events
  • NULL to disable SWI event notification
Returns:
eQCWWAN_ERR_NONE on success, eQCWWAN_xxx error value otherwise
See also:
See qmerrno.h for eQCWWAN_xxx error values
Note:
Technology Supported: N/A
Device Supported: N/A
Timeout: N/A
The following signals will trigger this callback:
          2 INT      4 ILL      5 TRAP     6 ABRT     7 BUS
          8 FPE     11 SEGV    13 PIPE    15 TERM    31 SYS
 
ULONG SLQSSetServingSystemCallback ( tFNServingSystem  pCallback  ) 

Enables/disables the Serving System callback function. The most recent successfully subscribed callback function will be the only function that is invoked when the corresponding event occurs.

Parameters:
pCallback[IN] 
  • a valid function pointer to enable ServingSystem notification
  • NULL to disable ServingSystem notification
Returns:
eQCWWAN_ERR_NONE on success, eQCWWAN_xxx error value otherwise
Note:
Technology Supported: UMTS/CDMA/LTE
Device Supported: MC83x5,MC77xx
Timeout: 2 seconds
ULONG SLQSSetSignalStrengthsCallback ( tFNSLQSSignalStrengths  pCallback,
struct SLQSSignalStrengthsIndReq pSLQSSignalStrengthsIndReq 
)

Enables/disables the Received Signal Strength Information callback function. The most recent successfully subscribed callback function will be the only function that is invoked when the corresponding event occurs.

Parameters:
pCallback[IN] 
  • Callback function pointer (0-Disable)
pSLQSSignalStrengthsIndReq 
Returns:
eQCWWAN_ERR_NONE on success, eQCWWAN_xxx error value otherwise
See also:
See qmerrno.h for eQCWWAN_xxx error values
Note:
Technology Supported: UMTS/CDMA
Device Supported: MC83x5, MC7700/10
Timeout: 2 seconds
The signal strength callback function is called when a threshold in the threshold array is crossed.
ULONG SLQSSetSMSEventCallback ( tFNSMSEvents  pCallback  ) 

Enables/disables the events related to SMS callback function. The most recent successfully subscribed callback function will be the only function that is invoked when the corresponding event occurs.

Parameters:
pCallback[IN] 
  • Callback function pointer (0 - Disable)
Returns:
eQCWWAN_ERR_NONE on success, eQCWWAN_xxx error value otherwise
Note:
Technology Supported: UMTS/CDMA
Device Supported: MC7750,GOBI,MC7700
Timeout: 2 seconds
ULONG SLQSSetSysSelectionPrefCallBack ( tFNSysSelectionPref  pCallback  ) 

Enables/disables the System Selection Preference callback function. The most recent successfully subscribed callback function will be the only function that is invoked when the corresponding event occurs.

Parameters:
pCallback[IN] 
  • a valid function pointer to enable System Selection Preference Indication notification
  • NULL to disable Band Preference notification
Returns:
eQCWWAN_ERR_NONE on success, eQCWWAN_xxx error value otherwise
Note:
Technology Supported: UMTS/CDMA
Device Supported: MC7700/10/50, MC83x5
Timeout: 2 seconds
To set the system selection preferences the API SLQSSetSysSelectionPref() should be used
ULONG SLQSSetTransLayerInfoCallback ( tFNtransLayerInfo  pCallback  ) 

Enables/disables the Transport Layer information callback function. The most recent successfully subscribed callback function will be the only function that is invoked when the corresponding event occurs.

Parameters:
pCallback[IN] 
  • Callback function pointer (0-Disable)
Returns:
eQCWWAN_ERR_NONE on success, eQCWWAN_xxx error value otherwise
See also:
See qmerrno.h for eQCWWAN_xxx error values
Note:
Technology Supported: UMTS/CDMA
Device Supported: MC7700/10/50
Timeout: 2 seconds
ULONG SLQSSetTransNWRegInfoCallback ( tFNtransNWRegInfo  pCallback  ) 

Enables/disables the Transport Network Registration information callback function. The most recent successfully subscribed callback function will be the only function that is invoked when the corresponding event occurs.

Parameters:
pCallback[IN] 
  • Callback function pointer (0-Disable)
Returns:
eQCWWAN_ERR_NONE on success, eQCWWAN_xxx error value otherwise
See also:
See qmerrno.h for eQCWWAN_xxx error values
Note:
Technology Supported: UMTS/CDMA
Device Supported: MC7700/10/50
Timeout: 2 seconds

Copyright (c) 2011 Sierra Wireless, Inc. All rights reserved