Call Service
[Mobile Services]

Detailed Description

This service set gives access to a call.

With the corresponding call id, you can dial a call, release it, get info on it (address, duration...) and manage it.

Data Structures

struct _AlpMblCall

struct _AlpMblCallHistory

struct _AlpMblCallHistoryList

struct _AlpMblCallList

struct _AlpMblCallUpdateInfo

Defines

#define ALP_MBL_CALL_ACCEPT_INFO_DEFAULT   ((AlpMblCallAcceptInfo) 0)

Default behavior to accept a call. If there is one or more active calls, they will be held and the incoming call will be accepetd. If there one or more held calls, they will remains held, and the incoming call will be accepted. If there is one or more active call and one or more held call, active calls will be released, and then the incoming call will be accepted.

#define ALP_MBL_CALL_ACCEPT_INFO_RELEASE_ACTIVE   ((AlpMblCallAcceptInfo) 1)

If there is one or more active calls, they will be released, and then the incoming call will be accepted. If there were held call, their status remains unchanged.

#define ALP_MBL_CALL_ACCEPT_INFO_RELEASE_HELD   ((AlpMblCallAcceptInfo) 2)

If there is one or more held calls, they will be released, and then the incoming call will be accepted. If there were active call, they will be put on hold.

#define ALP_MBL_CALL_DIRECTION_INCOMING   ((AlpMblCallDirection) 2)

Incoming call: Mobile terminated call, from the Network to the Teminal.

#define ALP_MBL_CALL_DIRECTION_OUTGOING   ((AlpMblCallDirection) 1)

Outgoing call: Mobile originated call, from the Terminal to the Network.

#define ALP_MBL_CALL_ERROR_ACTION_REQUESTED_BY_CALL_CONTROL   ((AlpMblCallError) 12)

The call is allowed with modifications.

#define ALP_MBL_CALL_ERROR_BARRED   ((AlpMblCallError) 15)

Call has been barred by network.

#define ALP_MBL_CALL_ERROR_BLOCKED   ((AlpMblCallError) 10)

The call has been blocked due to restriction list.

#define ALP_MBL_CALL_ERROR_BUSY   ((AlpMblCallError) 2)

Call is busy.

#define ALP_MBL_CALL_ERROR_COST_LIMIT   ((AlpMblCallError) 14)

Call failed due to cost limit reached.

#define ALP_MBL_CALL_ERROR_NO_CARRIER   ((AlpMblCallError) 3)

There is no carrier.

#define ALP_MBL_CALL_ERROR_NO_CARRIER_EMERGENCY_ONLY   ((AlpMblCallError) 8)

There is no carrier, except for emergency call.

#define ALP_MBL_CALL_ERROR_NO_ERROR   ((AlpMblCallError) 0)

No call error.

#define ALP_MBL_CALL_ERROR_NOT_ALLOWED   ((AlpMblCallError) 4)

Operation on this call is not allowed.

#define ALP_MBL_CALL_ERROR_NOT_ALLOWED_BY_CALL_CONTROL   ((AlpMblCallError) 11)

The call is not allowed by Call Control.

#define ALP_MBL_CALL_ERROR_NOT_SUPPORTED   ((AlpMblCallError) 7)

This type of call is not supported.

#define ALP_MBL_CALL_ERROR_NWK_UNABLE_TO_PROCESS_COMMAND   ((AlpMblCallError) 13)

Call has been released because the network is unable to process the cmd.

#define ALP_MBL_CALL_ERROR_RELEASE_BY_PEER   ((AlpMblCallError) 5)

Call has been released by the peer.

#define ALP_MBL_CALL_ERROR_RELEASE_BY_USER   ((AlpMblCallError) 6)

Call has been released by the user.

#define ALP_MBL_CALL_ERROR_SS_DETECTED   ((AlpMblCallError) 9)

The dial string is a Supplementary Services.

#define ALP_MBL_CALL_ERROR_UNKNOWN   ((AlpMblCallError) 1)

Unknow call error.

#define ALP_MBL_CALL_FILTER_ACTIVE   ((AlpMblCallFilter) 2)

All active calls.

#define ALP_MBL_CALL_FILTER_ALL   ((AlpMblCallFilter) 1)

All calls.

#define ALP_MBL_CALL_FILTER_ON_HOLD   ((AlpMblCallFilter) 3)

All hold calls.

#define ALP_MBL_CALL_HISTORY_TYPE_ALL   ((AlpMblCallHistoryType) 0)

All calls.

#define ALP_MBL_CALL_HISTORY_TYPE_DIALED   ((AlpMblCallHistoryType) 3)

All dialed calls.

#define ALP_MBL_CALL_HISTORY_TYPE_MISSED   ((AlpMblCallHistoryType) 1)

All missed calls.

#define ALP_MBL_CALL_HISTORY_TYPE_RECEIVED   ((AlpMblCallHistoryType) 2)

All received calls.

#define ALP_MBL_CALL_HISTORY_TYPE_RECENT   ((AlpMblCallHistoryType) 4)

All recent calls: dialed called, without duplicate.

#define ALP_MBL_CALL_IN_MULTIPARTY_CONFERENCE   true

Call is part of a multi-party conference group.

#define ALP_MBL_CALL_INFO_CALL_CONFERENCE_BY_REMOTE   ((AlpMblCallInfo) 6)

A call has been add into a conference by remote.

#define ALP_MBL_CALL_INFO_CALL_HOLD_BY_REMOTE   ((AlpMblCallInfo) 4)

A call has been put on hold by remote.

#define ALP_MBL_CALL_INFO_CALL_RESUMED_BY_REMOTE   ((AlpMblCallInfo) 5)

A call has been resumed by remote.

#define ALP_MBL_CALL_INFO_MO_CALL_FORWARDED   ((AlpMblCallInfo) 2)

MO call: the outgoing call is forwarded.

#define ALP_MBL_CALL_INFO_MO_CALL_IS_WAITING   ((AlpMblCallInfo) 1)

MO call: the outgoing call is waiting on remote side.

#define ALP_MBL_CALL_INFO_MT_CALL_FORWARDED   ((AlpMblCallInfo) 3)

MT call: the incoming call is a forwarded call.

#define ALP_MBL_CALL_INFO_NO_EXTRA_INFO   ((AlpMblCallInfo) 0)

No extra information.

#define ALP_MBL_CALL_NOT_IN_MULTIPARTY_CONFERENCE   false

Call is not part of a multi-party conference group.

#define ALP_MBL_CALL_NOTIFICATION_ADDRESS_AVAILABLE   ((AlpMblNotificationId) 2)

The Address information of a call is available.

#define ALP_MBL_CALL_NOTIFICATION_CALL_ERROR   ((AlpMblNotificationId) 4)

A call error occurs.

#define ALP_MBL_CALL_NOTIFICATION_CCBS_POSSIBLE   ((AlpMblNotificationId) 6)

Calling party is busy, and call completion of busy subscriber is possible.

#define ALP_MBL_CALL_NOTIFICATION_CONTACT_AVAILABLE   ((AlpMblNotificationId) 3)

The Contact information of a call is available.

#define ALP_MBL_CALL_NOTIFICATION_COST_CHANGE   ((AlpMblNotificationId) 5)

The cost of a call has changed.

#define ALP_MBL_CALL_NOTIFICATION_STATUS_CHANGE   ((AlpMblNotificationId) 1)

The status of a call has changed.

#define ALP_MBL_CALL_STATUS_ACTIVE   ((AlpMblCallStatus) 2)

Call is active.

#define ALP_MBL_CALL_STATUS_ALERTING   ((AlpMblCallStatus) 5)

Alerting in progress.

#define ALP_MBL_CALL_STATUS_DIALING   ((AlpMblCallStatus) 4)

Dialling in progress.

#define ALP_MBL_CALL_STATUS_IDLE   ((AlpMblCallStatus) 1)

Idle state.

#define ALP_MBL_CALL_STATUS_INCOMING   ((AlpMblCallStatus) 6)

Incoming call.

#define ALP_MBL_CALL_STATUS_ON_HOLD   ((AlpMblCallStatus) 3)

Call is on hold.

#define ALP_MBL_CALL_STATUS_RELEASED   ((AlpMblCallStatus) 8)

Call is released.

#define ALP_MBL_CALL_STATUS_WAITING   ((AlpMblCallStatus) 7)

Waiting call.

#define ALP_MBL_CALL_TYPE_VIDEO   ((AlpMblCallType) 1)

Video telephony call.

#define ALP_MBL_CALL_TYPE_VOICE   ((AlpMblCallType) 0)

Voice only call.

Typedefs

typedef _AlpMblCall AlpMblCall

typedef unsigned char AlpMblCallAcceptInfo

Info on the way to accept a call. See ALP_MBL_CALL_ACCEPT_INFO_XXX defines.

typedef void(* AlpMblCallAddressAvailableCallbackPtr )(void *iUserDataP, AlpMblCallId iCallId, AlpMblAddress iAddress)

typedef void(* AlpMblCallCCBSPossibleCallbackPtr )(void *iUserDataP, AlpMblCallId iCallId)

typedef void(* AlpMblCallContactAvailableCallbackPtr )(void *iUserDataP, AlpMblCallId iCallId, AlpLuid iPersonLuid, AlpLuid iContactLuid)

typedef void(* AlpMblCallCostChangeCallbackPtr )(void *iUserDataP, AlpMblCallId iCallId, AlpMblCost iPrevious, AlpMblCost iCurrent)

typedef unsigned long AlpMblCallDate

Call date: number of seconds since January 1, 1970.

typedef unsigned char AlpMblCallDirection

typedef unsigned long AlpMblCallDuration

Call duration, in seconds.

typedef unsigned char AlpMblCallError

Call error: see ALP_MBL_CALL_XXX defines.

typedef void(* AlpMblCallErrorCallbackPtr )(void *iUserDataP, AlpMblAddress iCallAddress, AlpLuid iPersonLuid, AlpMblCallError iCallError)

typedef unsigned char AlpMblCallFilter

typedef _AlpMblCallHistory AlpMblCallHistory

typedef _AlpMblCallHistoryList AlpMblCallHistoryList

typedef unsigned char AlpMblCallHistoryType

Type of call history.

typedef unsigned short AlpMblCallId

typedef unsigned char AlpMblCallInfo

Call extra information: see ALP_MBL_CALL_INFO_XXX defines.

typedef _AlpMblCallList AlpMblCallList

typedef char AlpMblCallName [64]

typedef unsigned char AlpMblCallStatus

typedef void(* AlpMblCallStatusChangeCallbackPtr )(void *iUserDataP, AlpMblCallId iCallId, AlpMblCallStatus iPrevious, AlpMblCallStatus iCurrent, bool iConferenceStatus, AlpMblCallError iCallError, AlpMblCallType iCallType, AlpMblCallInfo iCallInfo)

typedef char AlpMblCallThumbnailUri [128]

typedef unsigned char AlpMblCallType

Type of call: voice only or video telephony call.

typedef _AlpMblCallUpdateInfo AlpMblCallUpdateInfo

Functions

alp_status_t alp_mbl_call_accept (AlpMblCallId iCallId, AlpMblCallAcceptInfo iAcceptInfo)

alp_status_t alp_mbl_call_activate_completion_to_busy_subscriber (AlpMblCallId iCallId)

alp_status_t alp_mbl_call_deflect (AlpMblCallId iCallId, AlpMblAddress iAddress)

alp_status_t alp_mbl_call_dial (AlpMblCallId iCallId)

alp_status_t alp_mbl_call_dial_dtmf (AlpMblCallId iCallId, char *iDtmfP)

alp_status_t alp_mbl_call_exclude_call (AlpMblCallId iCallId)

alp_status_t alp_mbl_call_get (AlpMblCallId iCallId, AlpMblCall *oCallP)

alp_status_t alp_mbl_call_get_address (AlpMblCallId iCallId, AlpMblAddress *oAddressP)

alp_status_t alp_mbl_call_get_conference (AlpMblCallId iCallId, AlpMblCallList *oCallListP)

alp_status_t alp_mbl_call_get_context_id (AlpMblCallId iCallId, AlpMblContextId *oContextIdP)

alp_status_t alp_mbl_call_get_cost (AlpMblCallId iCallId, AlpMblCost *oCostP)

alp_status_t alp_mbl_call_get_date (AlpMblCallId iCallId, AlpMblCallDate *oDateP)

alp_status_t alp_mbl_call_get_direction (AlpMblCallId iCallId, AlpMblCallDirection *oDirectionP)

alp_status_t alp_mbl_call_get_duration (AlpMblCallId iCallId, AlpMblCallDuration *oDurationP)

alp_status_t alp_mbl_call_get_info (AlpMblCallId iCallId, AlpMblCallInfo *oInfoP)

alp_status_t alp_mbl_call_get_line_id (AlpMblCallId iCallId, AlpMblLineId *oLineIdP)

alp_status_t alp_mbl_call_get_luid (AlpMblCallId iCallId, AlpLuid *oPersonLuidP) __attribute((deprecated))

alp_status_t alp_mbl_call_get_luids (AlpMblCallId iCallId, AlpLuid *oPersonLuidP, AlpLuid *oContactLuidP)

alp_status_t alp_mbl_call_get_name (AlpMblCallId iCallId, AlpMblCallName *oNameP)

alp_status_t alp_mbl_call_get_status (AlpMblCallId iCallId, AlpMblCallStatus *oStatusP)

alp_status_t alp_mbl_call_get_thumbnail (AlpMblCallId iCallId, AlpMblCallThumbnailUri *oThumbnailUriP)

alp_status_t alp_mbl_call_get_type (AlpMblCallId iCallId, AlpMblCallType *oTypeP)

alp_status_t alp_mbl_call_hold (AlpMblCallId iCallId)

alp_status_t alp_mbl_call_is_conference (AlpMblCallId iCallId, bool *oIsConferenceP)

alp_status_t alp_mbl_call_is_emergency (AlpMblCallId iCallId, bool *oIsEmergencyP)

alp_status_t alp_mbl_call_is_roaming (AlpMblCallId iCallId, bool *oIsRoamingP)

alp_status_t alp_mbl_call_join_call (AlpMblCallId iCallId, AlpMblCallId iCallIdToJoin)

alp_status_t alp_mbl_call_private_call (AlpMblCallId iCallId)

alp_status_t alp_mbl_call_reject (AlpMblCallId iCallId)

alp_status_t alp_mbl_call_release (AlpMblCallId iCallId)

alp_status_t alp_mbl_call_release_conference (AlpMblCallId iCallId)

alp_status_t alp_mbl_call_send_dtmf (AlpMblCallId iCallId, char *iDtmfP)

alp_status_t alp_mbl_call_transfer (AlpMblCallId iCallId, AlpMblCallId iTransferToCallId)

alp_status_t alp_mbl_call_transfert (AlpMblCallId iCallId, AlpMblCallId iTransfertToCallId) __attribute((deprecated))

Define Documentation

#define ALP_MBL_CALL_ACCEPT_INFO_DEFAULT ((AlpMblCallAcceptInfo) 0)

Default behavior to accept a call. If there is one or more active calls, they will be held and the incoming call will be accepetd. If there one or more held calls, they will remains held, and the incoming call will be accepted. If there is one or more active call and one or more held call, active calls will be released, and then the incoming call will be accepted.

#define ALP_MBL_CALL_ACCEPT_INFO_RELEASE_ACTIVE ((AlpMblCallAcceptInfo) 1)

If there is one or more active calls, they will be released, and then the incoming call will be accepted. If there were held call, their status remains unchanged.

#define ALP_MBL_CALL_ACCEPT_INFO_RELEASE_HELD ((AlpMblCallAcceptInfo) 2)

If there is one or more held calls, they will be released, and then the incoming call will be accepted. If there were active call, they will be put on hold.

#define ALP_MBL_CALL_DIRECTION_INCOMING ((AlpMblCallDirection) 2)

Incoming call: Mobile terminated call, from the Network to the Teminal.

#define ALP_MBL_CALL_DIRECTION_OUTGOING ((AlpMblCallDirection) 1)

Outgoing call: Mobile originated call, from the Terminal to the Network.

#define ALP_MBL_CALL_ERROR_ACTION_REQUESTED_BY_CALL_CONTROL ((AlpMblCallError) 12)

The call is allowed with modifications.

#define ALP_MBL_CALL_ERROR_BARRED ((AlpMblCallError) 15)

Call has been barred by network.

#define ALP_MBL_CALL_ERROR_BLOCKED ((AlpMblCallError) 10)

The call has been blocked due to restriction list.

#define ALP_MBL_CALL_ERROR_BUSY ((AlpMblCallError) 2)

Call is busy.

#define ALP_MBL_CALL_ERROR_COST_LIMIT ((AlpMblCallError) 14)

Call failed due to cost limit reached.

#define ALP_MBL_CALL_ERROR_NO_CARRIER ((AlpMblCallError) 3)

There is no carrier.

#define ALP_MBL_CALL_ERROR_NO_CARRIER_EMERGENCY_ONLY ((AlpMblCallError) 8)

There is no carrier, except for emergency call.

#define ALP_MBL_CALL_ERROR_NO_ERROR ((AlpMblCallError) 0)

No call error.

#define ALP_MBL_CALL_ERROR_NOT_ALLOWED ((AlpMblCallError) 4)

Operation on this call is not allowed.

#define ALP_MBL_CALL_ERROR_NOT_ALLOWED_BY_CALL_CONTROL ((AlpMblCallError) 11)

The call is not allowed by Call Control.

#define ALP_MBL_CALL_ERROR_NOT_SUPPORTED ((AlpMblCallError) 7)

This type of call is not supported.

#define ALP_MBL_CALL_ERROR_NWK_UNABLE_TO_PROCESS_COMMAND ((AlpMblCallError) 13)

Call has been released because the network is unable to process the cmd.

#define ALP_MBL_CALL_ERROR_RELEASE_BY_PEER ((AlpMblCallError) 5)

Call has been released by the peer.

#define ALP_MBL_CALL_ERROR_RELEASE_BY_USER ((AlpMblCallError) 6)

Call has been released by the user.

#define ALP_MBL_CALL_ERROR_SS_DETECTED ((AlpMblCallError) 9)

The dial string is a Supplementary Services.

#define ALP_MBL_CALL_ERROR_UNKNOWN ((AlpMblCallError) 1)

Unknow call error.

#define ALP_MBL_CALL_FILTER_ACTIVE ((AlpMblCallFilter) 2)

All active calls.

#define ALP_MBL_CALL_FILTER_ALL ((AlpMblCallFilter) 1)

All calls.

#define ALP_MBL_CALL_FILTER_ON_HOLD ((AlpMblCallFilter) 3)

All hold calls.

#define ALP_MBL_CALL_HISTORY_TYPE_ALL ((AlpMblCallHistoryType) 0)

All calls.

#define ALP_MBL_CALL_HISTORY_TYPE_DIALED ((AlpMblCallHistoryType) 3)

All dialed calls.

#define ALP_MBL_CALL_HISTORY_TYPE_MISSED ((AlpMblCallHistoryType) 1)

All missed calls.

#define ALP_MBL_CALL_HISTORY_TYPE_RECEIVED ((AlpMblCallHistoryType) 2)

All received calls.

#define ALP_MBL_CALL_HISTORY_TYPE_RECENT ((AlpMblCallHistoryType) 4)

All recent calls: dialed called, without duplicate.

#define ALP_MBL_CALL_IN_MULTIPARTY_CONFERENCE true

Call is part of a multi-party conference group.

#define ALP_MBL_CALL_INFO_CALL_CONFERENCE_BY_REMOTE ((AlpMblCallInfo) 6)

A call has been add into a conference by remote.

#define ALP_MBL_CALL_INFO_CALL_HOLD_BY_REMOTE ((AlpMblCallInfo) 4)

A call has been put on hold by remote.

#define ALP_MBL_CALL_INFO_CALL_RESUMED_BY_REMOTE ((AlpMblCallInfo) 5)

A call has been resumed by remote.

#define ALP_MBL_CALL_INFO_MO_CALL_FORWARDED ((AlpMblCallInfo) 2)

MO call: the outgoing call is forwarded.

#define ALP_MBL_CALL_INFO_MO_CALL_IS_WAITING ((AlpMblCallInfo) 1)

MO call: the outgoing call is waiting on remote side.

#define ALP_MBL_CALL_INFO_MT_CALL_FORWARDED ((AlpMblCallInfo) 3)

MT call: the incoming call is a forwarded call.

#define ALP_MBL_CALL_INFO_NO_EXTRA_INFO ((AlpMblCallInfo) 0)

No extra information.

#define ALP_MBL_CALL_NOT_IN_MULTIPARTY_CONFERENCE false

Call is not part of a multi-party conference group.

#define ALP_MBL_CALL_NOTIFICATION_ADDRESS_AVAILABLE ((AlpMblNotificationId) 2)

The Address information of a call is available.

#define ALP_MBL_CALL_NOTIFICATION_CALL_ERROR ((AlpMblNotificationId) 4)

A call error occurs.

#define ALP_MBL_CALL_NOTIFICATION_CCBS_POSSIBLE ((AlpMblNotificationId) 6)

Calling party is busy, and call completion of busy subscriber is possible.

#define ALP_MBL_CALL_NOTIFICATION_CONTACT_AVAILABLE ((AlpMblNotificationId) 3)

The Contact information of a call is available.

#define ALP_MBL_CALL_NOTIFICATION_COST_CHANGE ((AlpMblNotificationId) 5)

The cost of a call has changed.

#define ALP_MBL_CALL_NOTIFICATION_STATUS_CHANGE ((AlpMblNotificationId) 1)

The status of a call has changed.

#define ALP_MBL_CALL_STATUS_ACTIVE ((AlpMblCallStatus) 2)

Call is active.

#define ALP_MBL_CALL_STATUS_ALERTING ((AlpMblCallStatus) 5)

Alerting in progress.

#define ALP_MBL_CALL_STATUS_DIALING ((AlpMblCallStatus) 4)

Dialling in progress.

#define ALP_MBL_CALL_STATUS_IDLE ((AlpMblCallStatus) 1)

Idle state.

#define ALP_MBL_CALL_STATUS_INCOMING ((AlpMblCallStatus) 6)

Incoming call.

#define ALP_MBL_CALL_STATUS_ON_HOLD ((AlpMblCallStatus) 3)

Call is on hold.

#define ALP_MBL_CALL_STATUS_RELEASED ((AlpMblCallStatus) 8)

Call is released.

#define ALP_MBL_CALL_STATUS_WAITING ((AlpMblCallStatus) 7)

Waiting call.

#define ALP_MBL_CALL_TYPE_VIDEO ((AlpMblCallType) 1)

Video telephony call.

#define ALP_MBL_CALL_TYPE_VOICE ((AlpMblCallType) 0)

Voice only call.

Typedef Documentation

typedef struct _AlpMblCall AlpMblCall

typedef unsigned char AlpMblCallAcceptInfo

Info on the way to accept a call. See ALP_MBL_CALL_ACCEPT_INFO_XXX defines.

typedef void(* AlpMblCallAddressAvailableCallbackPtr)(void *iUserDataP, AlpMblCallId iCallId, AlpMblAddress iAddress)

Callback prototype for ALP_MBL_CALL_NOTIFICATION_ADDRESS_AVAILABLE notification of the ALP_MBL_CALL_SERVICE_ID service.
Parameters:

[in] iUserDataP - A pointer to user data info, given with the alp_mbl_add_observers() function call.

[in] iCallId - Id of the call that the address is available.

[in] iAddress - Address of the call.

typedef void(* AlpMblCallCCBSPossibleCallbackPtr)(void *iUserDataP, AlpMblCallId iCallId)

Callback prototype for ALP_MBL_CALL_NOTIFICATION_CCBS_POSSIBLE notification of the ALP_MBL_CALL_SERVICE_ID service.
Parameters:

[in] iUserDataP - A pointer to user data info, given with the alp_mbl_add_observers() function call.

[in] iCallId - Id of the call that the CCBS is possible.

typedef void(* AlpMblCallContactAvailableCallbackPtr)(void *iUserDataP, AlpMblCallId iCallId, AlpLuid iPersonLuid, AlpLuid iContactLuid)

Callback prototype for ALP_MBL_CALL_NOTIFICATION_CONTACT_AVAILABLE notification of the ALP_MBL_CALL_SERVICE_ID service.
Parameters:

[in] iUserDataP - A pointer to user data info, given with the alp_mbl_add_observers() function call.

[in] iCallId - Id of the call that the person luid and contact luid are available.

[in] iPersonLuid - Person luid of the call.

[in] iContactLuid - Contact luid of the call.

typedef void(* AlpMblCallCostChangeCallbackPtr)(void *iUserDataP, AlpMblCallId iCallId, AlpMblCost iPrevious, AlpMblCost iCurrent)

Callback prototype for ALP_MBL_CALL_NOTIFICATION_COST_CHANGE notification of the ALP_MBL_CALL_SERVICE_ID service.
Parameters:

[in] iUserDataP - A pointer to user data info, given with the alp_mbl_add_observers() function call.

[in] iCallId - Id of the call that the cost has change.

[in] iPrevious - Previous cost of the call.

[in] iCurrent - New cost of the call.

typedef unsigned long AlpMblCallDate

Call date: number of seconds since January 1, 1970.

typedef unsigned char AlpMblCallDirection

typedef unsigned long AlpMblCallDuration

Call duration, in seconds.

typedef unsigned char AlpMblCallError

Call error: see ALP_MBL_CALL_XXX defines.

typedef void(* AlpMblCallErrorCallbackPtr)(void *iUserDataP, AlpMblAddress iCallAddress, AlpLuid iPersonLuid, AlpMblCallError iCallError)

Callback prototype for ALP_MBL_CALL_NOTIFICATION_CALL_ERROR notification of the ALP_MBL_CALL_SERVICE_ID service.

typedef unsigned char AlpMblCallFilter

typedef struct _AlpMblCallHistory AlpMblCallHistory

typedef struct _AlpMblCallHistoryList AlpMblCallHistoryList

typedef unsigned char AlpMblCallHistoryType

Type of call history.

typedef unsigned short AlpMblCallId

typedef unsigned char AlpMblCallInfo

Call extra information: see ALP_MBL_CALL_INFO_XXX defines.

typedef struct _AlpMblCallList AlpMblCallList

typedef char AlpMblCallName[64]

typedef unsigned char AlpMblCallStatus

typedef void(* AlpMblCallStatusChangeCallbackPtr)(void *iUserDataP, AlpMblCallId iCallId, AlpMblCallStatus iPrevious, AlpMblCallStatus iCurrent, bool iConferenceStatus, AlpMblCallError iCallError, AlpMblCallType iCallType, AlpMblCallInfo iCallInfo)

Callback prototype for ALP_MBL_CALL_NOTIFICATION_STATUS_CHANGE notification of the ALP_MBL_CALL_SERVICE_ID service.
Parameters:

[in] iUserDataP - A pointer to user data info, given with the alp_mbl_add_observers() function call.

[in] iCallId - Id of the call that the status has change.

[in] iPrevious - Previous status of the call. See ALP_MBL_CALL_STATUS_XXX defines.

[in] iCurrent - New status of the call. See ALP_MBL_CALL_STATUS_XXX defines.

[in] iConferenceStatus - True if the call is in a conference, false otherwise.

[in] iCallError - Extra information if the new call status is ALP_MBL_CALL_STATUS_RELEASED. Otherwise, ALP_MBL_CALL_ERROR_NO_ERROR. See ALP_MBL_CALL_ERROR_XXX defines.

[in] iCallType - Type of call. Must be ALP_MBL_CALL_TYPE_VOICE or ALP_MBL_CALL_TYPE_VIDEO.

[in] iCallInfo - Extra info on the call, see ALP_MBL_CALL_INFO_XXX defines.

typedef char AlpMblCallThumbnailUri[128]

typedef unsigned char AlpMblCallType

Type of call: voice only or video telephony call.

typedef struct _AlpMblCallUpdateInfo AlpMblCallUpdateInfo

Function Documentation

alp_status_t alp_mbl_call_accept ( AlpMblCallId iCallId,

AlpMblCallAcceptInfo iAcceptInfo

)

Accept a call. Only a call in ALP_MBL_CALL_STATUS_INCOMING or ALP_MBL_CALL_STATUS_WAITING state could be accepted.

Parameters:

[in] iCallId - Id of the call to accept.

[in] iAcceptInfo - Info on the way to accept the call. See ALP_MBL_CALL_ACCEPT_INFO_XXX defines.

Returns:
ALP_STATUS_OK - The call has been accepted successfully.
ALP_STATUS_MBL_IPC_ERROR - Communication problem between library and server.
ALP_STATUS_MBL_MEMORY_ERROR - System is out of enough memory.
ALP_STATUS_MBL_INVALID_OBJECT - The call id is not valid: the call doesn't exist or its status is not ALP_MBL_CALL_STATUS_INCOMING or ALP_MBL_CALL_STATUS_WAITING.

Since:
ALP iSDK 1.0

alp_status_t alp_mbl_call_activate_completion_to_busy_subscriber ( AlpMblCallId iCallId )

Activate the call completion to busy subscriber service. Only a call that has receive the ALP_MBL_CALL_NOTIFICATION_CCBS_POSSIBLE notification could activate the CCBS.

Parameters:

[in] iCallId - Id of the call to activate the CCBS.

Returns:
ALP_STATUS_OK - The CCBS has been activated successfully.
ALP_STATUS_MBL_IPC_ERROR - Communication problem between library and server.
ALP_STATUS_MBL_MEMORY_ERROR - System is out of enough memory.
ALP_STATUS_MBL_INVALID_OBJECT - The call id is not valid: the call doesn't exist or its status doesn't allo the CCBS.

Since:
ALP iSDK 1.1

alp_status_t alp_mbl_call_deflect ( AlpMblCallId iCallId,

AlpMblAddress iAddress

)

Deflect a call to another address. Only a call in ALP_MBL_CALL_STATUS_INCOMING or ALP_MBL_CALL_STATUS_WAITING state could be deflected.

Parameters:

[in] iCallId - Id of the call to deflect.

[in] iAddress - The address to deflect the call to.

Returns:
ALP_STATUS_OK - The call has been deflected successfully.
ALP_STATUS_MBL_IPC_ERROR - Communication problem between library and server.
ALP_STATUS_MBL_MEMORY_ERROR - System is out of enough memory.
ALP_STATUS_MBL_INVALID_OBJECT - The call id is not valid: the call doesn't exist or its status is not ALP_MBL_CALL_STATUS_INCOMING or ALP_MBL_CALL_STATUS_WAITING.

Since:
ALP iSDK 1.1

alp_status_t alp_mbl_call_dial ( AlpMblCallId iCallId )

Dial a call. Only a call in ALP_MBL_CALL_STATUS_IDLE state could be dialed.

Parameters:

[in] iCallId - Id of the call to dial.

Returns:
ALP_STATUS_OK - The call is dialing.
ALP_STATUS_MBL_IPC_ERROR - Communication problem between library and server.
ALP_STATUS_MBL_MEMORY_ERROR - System is out of enough memory.
ALP_STATUS_MBL_INVALID_OBJECT - The call id is not valid: the call doesn't exist or its status is not valid to perform a dial.

Example:
You can see an example of use with the description of the function alp_mbl_context_new_emergency_call().

Since:
ALP iSDK 1.0

alp_status_t alp_mbl_call_dial_dtmf ( AlpMblCallId iCallId,

char * iDtmfP

)

Dial a call, and as soon as the call is connected, send some DTMF characters.

Parameters:

[in] iCallId - Id of the call to dial.

[in] iDtmfP - A pointer to the DTMF characters to send.

Returns:
ALP_STATUS_OK - The call is dialing.
ALP_STATUS_MBL_IPC_ERROR - Communication problem between library and server.
ALP_STATUS_MBL_MEMORY_ERROR - System is out of enough memory.
ALP_STATUS_MBL_INVALID_OBJECT - The call id is not valid: the call doesn't exist or its status is not valid to perform a dial.
ALP_STATUS_MBL_INVALID_PARAMETER - iDtmfP is NULL, and it's not valid.

Since:
ALP iSDK 1.0

alp_status_t alp_mbl_call_exclude_call ( AlpMblCallId iCallId )

Remove a call from a conference. The conference will remains active, and the removed call will be on hold.

Parameters:

[in] iCallId - Id of the call to exclude from a conference.

Returns:
ALP_STATUS_OK - The call has been excluded successfully.
ALP_STATUS_MBL_IPC_ERROR - Communication problem between library and server.
ALP_STATUS_MBL_MEMORY_ERROR - System is out of enough memory.
ALP_STATUS_MBL_INVALID_OBJECT - The call id is not valid: the call doesn't exist, or the call is not in a conference.

Since:
ALP iSDK 2.3

alp_status_t alp_mbl_call_get ( AlpMblCallId iCallId,

AlpMblCall * oCallP

)

Return all info of a call.

Parameters:

[in] iCallId - Id of the call to get its info.

[out] oCallP - Pointer to & AlpMblCall, to store all the call info upon return.

Returns:
ALP_STATUS_OK - The info has been retrieved successfully.
ALP_STATUS_MBL_IPC_ERROR - Communication problem between library and server.
ALP_STATUS_MBL_MEMORY_ERROR - System is out of enough memory.
ALP_STATUS_MBL_INVALID_OBJECT - The call id is not valid: the call doesn't exist, or it's status is ALP_MBL_CALL_STATUS_IDLE and it's not valid.
ALP_STATUS_MBL_INVALID_PARAMETER - oCallP is NULL, and it's not valid.

Since:
ALP iSDK 2.4

alp_status_t alp_mbl_call_get_address ( AlpMblCallId iCallId,

AlpMblAddress * oAddressP

)

Return the address of a call.

Parameters:

[in] iCallId - Id of the call to get the address.

[out] oAddressP - Pointer to an AlpMblAddress, to store the address upon return.

Returns:
ALP_STATUS_OK - The address has been retrieved successfully.
ALP_STATUS_MBL_IPC_ERROR - Communication problem between library and server.
ALP_STATUS_MBL_MEMORY_ERROR - System is out of enough memory.
ALP_STATUS_MBL_INVALID_OBJECT - The call id is not valid: the call doesn't exist.
ALP_STATUS_MBL_INVALID_PARAMETER - oAddressP is NULL, and it's not valid.

Since:
ALP iSDK 1.0

alp_status_t alp_mbl_call_get_conference ( AlpMblCallId iCallId,

AlpMblCallList * oCallListP

)

Return the list of call id that are attached to a call

Parameters:

[in] iCallId - A call id that is present in the conference.

[out] oCallListP - List of the call that are attached to the call.

Returns:
ALP_STATUS_OK - The call list has been returned successfully.
ALP_STATUS_MBL_IPC_ERROR - Communication problem between library and server.
ALP_STATUS_MBL_MEMORY_ERROR - System is out of enough memory.
ALP_STATUS_MBL_INVALID_OBJECT - The call id is not valid: the call doesn't exist.
ALP_STATUS_MBL_INVALID_PARAMETER - oCallListP is NULL, and it's not valid.

Since:
ALP iSDK 1.0

alp_status_t alp_mbl_call_get_context_id ( AlpMblCallId iCallId,

AlpMblContextId * oContextIdP

)

Return the Mobile Context associated to a call.

Parameters:

[in] iCallId - Id of the call to get the duration.

[out] oContextIdP - Pointer to an AlpMblContextId, to store the Mobile Context id upon return.

Returns:
ALP_STATUS_OK - The associated mobile context id has been retrieved successfully.
ALP_STATUS_MBL_IPC_ERROR - Communication problem between library and server.
ALP_STATUS_MBL_MEMORY_ERROR - System is out of enough memory.
ALP_STATUS_MBL_INVALID_OBJECT - The call id is not valid: the call doesn't exist.
ALP_STATUS_MBL_INVALID_PARAMETER - oContextIdP is NULL, and it's not valid.

Since:
ALP iSDK 1.0

alp_status_t alp_mbl_call_get_cost ( AlpMblCallId iCallId,

AlpMblCost * oCostP

)

Return the cost of a call.

Parameters:

[in] iCallId - Id of the call to get the duration.

[out] oCostP - Pointer to an AlpMblCost, to store the cost of the call upon return.

Returns:
ALP_STATUS_OK - The cost of the call has been retrieved successfully.
ALP_STATUS_MBL_IPC_ERROR - Communication problem between library and server.
ALP_STATUS_MBL_MEMORY_ERROR - System is out of enough memory.
ALP_STATUS_MBL_INVALID_OBJECT - The call id is not valid: the call doesn't exist.
ALP_STATUS_MBL_INVALID_PARAMETER - oCostP is NULL, and it's not valid.

Since:
ALP iSDK 1.1

alp_status_t alp_mbl_call_get_date ( AlpMblCallId iCallId,

AlpMblCallDate * oDateP

)

Return the date of a call.

Parameters:

[in] iCallId - Id of the call to get the date.

[out] oDateP - Pointer to an AlpMblCallDate, to store the date upon return.

Returns:
ALP_STATUS_OK - The date has been retrieved successfully.
ALP_STATUS_MBL_IPC_ERROR - Communication problem between library and server.
ALP_STATUS_MBL_MEMORY_ERROR - System is out of enough memory.
ALP_STATUS_MBL_INVALID_OBJECT - The call id is not valid: the call doesn't exist.
ALP_STATUS_MBL_INVALID_PARAMETER - oDateP is NULL, and it's not valid.

Since:
ALP iSDK 1.0

alp_status_t alp_mbl_call_get_direction ( AlpMblCallId iCallId,

AlpMblCallDirection * oDirectionP

)

Return the direction of a call: ALP_MBL_CALL_DIRECTION_OUTGOING or ALP_MBL_CALL_DIRECTION_INCOMING.

Parameters:

[in] iCallId - Id of the call to get the direction.

[out] oDirectionP - Pointer to an AlpMblCallDirection, to store the direction upon return.

Returns:
ALP_STATUS_OK - The direction has been retrieved successfully.
ALP_STATUS_MBL_IPC_ERROR - Communication problem between library and server.
ALP_STATUS_MBL_MEMORY_ERROR - System is out of enough memory.
ALP_STATUS_MBL_INVALID_OBJECT - The call id is not valid: the call doesn't exist.
ALP_STATUS_MBL_INVALID_PARAMETER - oDirectionP is NULL, and it's not valid.

Since:
ALP iSDK 1.0

alp_status_t alp_mbl_call_get_duration ( AlpMblCallId iCallId,

AlpMblCallDuration * oDurationP

)

Return the duration of a call.

Parameters:

[in] iCallId - Id of the call to get the duration.

[out] oDurationP - Pointer to an AlpMblCallDuration, to store the duration upon return.

Returns:
ALP_STATUS_OK - The duration has been retrieved successfully.
ALP_STATUS_MBL_IPC_ERROR - Communication problem between library and server.
ALP_STATUS_MBL_MEMORY_ERROR - System is out of enough memory.
ALP_STATUS_MBL_INVALID_OBJECT - The call id is not valid: the call doesn't exist.
ALP_STATUS_MBL_INVALID_PARAMETER - oDurationP is NULL, and it's not valid.

Since:
ALP iSDK 1.0

alp_status_t alp_mbl_call_get_info ( AlpMblCallId iCallId,

AlpMblCallInfo * oInfoP

)

Return some extra info of a call: see ALP_MBL_CALL_INFO_XXX defines.

Parameters:

[in] iCallId - Id of the call to get some extra info.

[out] oInfoP - Pointer to an AlpMblCallInfo, to store the info upon return.

Returns:
ALP_STATUS_OK - The info has been retrieved successfully.
ALP_STATUS_MBL_IPC_ERROR - Communication problem between library and server.
ALP_STATUS_MBL_MEMORY_ERROR - System is out of enough memory.
ALP_STATUS_MBL_INVALID_OBJECT - The call id is not valid: the call doesn't exist.
ALP_STATUS_MBL_INVALID_PARAMETER - oInfoP is NULL, and it's not valid.

Since:
ALP iSDK 2.4

alp_status_t alp_mbl_call_get_line_id ( AlpMblCallId iCallId,

AlpMblLineId * oLineIdP

)

Return the id of the line associated to a call.

Parameters:

[in] iCallId - Id of the call to get its line id.

[out] oLineIdP - Pointer to an AlpMblLineId, to store the line id upon return.

Returns:
ALP_STATUS_OK - The line id has been retrieved successfully.
ALP_STATUS_MBL_IPC_ERROR - Communication problem between library and server.
ALP_STATUS_MBL_MEMORY_ERROR - System is out of enough memory.
ALP_STATUS_MBL_INVALID_OBJECT - The call id is not valid: the call doesn't exist, or it's status is ALP_MBL_CALL_STATUS_IDLE and it's not valid.
ALP_STATUS_MBL_INVALID_PARAMETER - oLineIdP is NULL, and it's not valid.

Since:
ALP iSDK 1.1

alp_status_t alp_mbl_call_get_luid ( AlpMblCallId iCallId,

AlpLuid * oPersonLuidP

)

Return the person luid associated to a call.

Parameters:

[in] iCallId - Id of the call to get the duration.

[out] oPersonLuidP - Pointer to an AlpLuid, to store the person luid upon return.

Returns:
ALP_STATUS_OK - The person luid has been retrieved successfully.
ALP_STATUS_MBL_IPC_ERROR - Communication problem between library and server.
ALP_STATUS_MBL_MEMORY_ERROR - System is out of enough memory.
ALP_STATUS_MBL_INVALID_OBJECT - The call id is not valid: the call doesn't exist.
ALP_STATUS_MBL_INVALID_PARAMETER - oPersonLuidP is NULL, and it's not valid.

Note:
Deprecated since ALP iSDK 1.1, use alp_mbl_call_get_luids().

Since:
ALP iSDK 1.0

alp_status_t alp_mbl_call_get_luids ( AlpMblCallId iCallId,

AlpLuid * oPersonLuidP,

AlpLuid * oContactLuidP

)

Return luids associated to a call.

Parameters:

[in] iCallId - Id of the call to get the duration.

[out] oPersonLuidP - Pointer to an AlpLuid, to store the person luid upon return.

[out] oContactLuidP - Pointer to an AlpLuid, to store the contact luid upon return.

Returns:
ALP_STATUS_OK - The luids has been retrieved successfully.
ALP_STATUS_MBL_IPC_ERROR - Communication problem between library and server.
ALP_STATUS_MBL_MEMORY_ERROR - System is out of enough memory.
ALP_STATUS_MBL_INVALID_OBJECT - The call id is not valid: the call doesn't exist.
ALP_STATUS_MBL_INVALID_PARAMETER - oPersonLuidP and oContactLuidP are NULL, and it's not valid.

Since:
ALP iSDK 1.1

alp_status_t alp_mbl_call_get_name ( AlpMblCallId iCallId,

AlpMblCallName * oNameP

)

Return the name associated with a call.

Parameters:

[in] iCallId - Id of the call to get the address.

[out] oNameP - Pointer to an AlpMblCallName, to store the name upon return.

Returns:
ALP_STATUS_OK - The name has been retrieved successfully.
ALP_STATUS_MBL_IPC_ERROR - Communication problem between library and server.
ALP_STATUS_MBL_MEMORY_ERROR - System is out of enough memory.
ALP_STATUS_MBL_INVALID_OBJECT - The call id is not valid: the call doesn't exist.
ALP_STATUS_MBL_INVALID_PARAMETER - oNameP is NULL, and it's not valid.

Since:
ALP iSDK 1.0

alp_status_t alp_mbl_call_get_status ( AlpMblCallId iCallId,

AlpMblCallStatus * oStatusP

)

Return the status of a call: see ALP_MBL_CALL_STATUS_XXX defines.

Parameters:

[in] iCallId - Id of the call to get the status.

[out] oStatusP - Pointer to an AlpMblCallStatus, to store the status upon return.

Returns:
ALP_STATUS_OK - The status has been retrieved successfully.
ALP_STATUS_MBL_IPC_ERROR - Communication problem between library and server.
ALP_STATUS_MBL_MEMORY_ERROR - System is out of enough memory.
ALP_STATUS_MBL_INVALID_OBJECT - The call id is not valid: the call doesn't exist.
ALP_STATUS_MBL_INVALID_PARAMETER - oStatusP is NULL, and it's not valid.

Since:
ALP iSDK 1.0

alp_status_t alp_mbl_call_get_thumbnail ( AlpMblCallId iCallId,

AlpMblCallThumbnailUri * oThumbnailUriP

)

Return the thumbnail URI associated to a call.

Parameters:

[in] iCallId - Id of the call to get its thumbnail URI associated.

[out] oThumbnailUriP - Pointer to a AlpMblCallThumbnailUri, to store the URI of the thumnbnail associated to a call upon return.

Returns:
ALP_STATUS_OK - The thumbnail URI has been retrieved successfully.
ALP_STATUS_MBL_IPC_ERROR - Communication problem between library and server.
ALP_STATUS_MBL_MEMORY_ERROR - System is out of enough memory.
ALP_STATUS_MBL_INVALID_OBJECT - The call id is not valid: the call doesn't exist, or it's status is ALP_MBL_CALL_STATUS_IDLE and it's not valid.
ALP_STATUS_MBL_INVALID_PARAMETER - oThumbnailUriP is NULL, and it's not valid.

Since:
ALP iSDK 2.4

alp_status_t alp_mbl_call_get_type ( AlpMblCallId iCallId,

AlpMblCallType * oTypeP

)

Return the type of a call: ALP_MBL_CALL_TYPE_VOICE or ALP_MBL_CALL_TYPE_VIDEO

Parameters:

[in] iCallId - Id of the call to get the duration.

[out] oTypeP - Pointer to an AlpMblCallType, to store the type of call upon return.

Returns:
ALP_STATUS_OK - The type of call has been retrieved successfully.
ALP_STATUS_MBL_IPC_ERROR - Communication problem between library and server.
ALP_STATUS_MBL_MEMORY_ERROR - System is out of enough memory.
ALP_STATUS_MBL_INVALID_OBJECT - The call id is not valid: the call doesn't exist.
ALP_STATUS_MBL_INVALID_PARAMETER - oTypeP is NULL, and it's not valid.

Since:
ALP iSDK 1.1

alp_status_t alp_mbl_call_hold ( AlpMblCallId iCallId )

Put a call on hold. Only a call in ALP_MBL_CALL_STATUS_ACTIVE could be put on hold. For GSM calls, when a call is put on hold, if there were already any calls on hold, there are then active.

Parameters:

[in] iCallId - Id of the call to put on hold.

Returns:
ALP_STATUS_OK - The call has been put on hold successfully.
ALP_STATUS_MBL_IPC_ERROR - Communication problem between library and server.
ALP_STATUS_MBL_MEMORY_ERROR - System is out of enough memory.
ALP_STATUS_MBL_INVALID_OBJECT - The call id is not valid: the call doesn't exist or its status is ALP_MBL_CALL_STATUS_ACTIVE.

Since:
ALP iSDK 1.0

alp_status_t alp_mbl_call_is_conference ( AlpMblCallId iCallId,

bool * oIsConferenceP

)

Check if the call is in a conference or not.

Parameters:

[in] iCallId - Id of the call to get the conference status.

[out] oIsConferenceP - True if the call is in a conference, false otherwise.

Returns:
ALP_STATUS_OK - The conference status has been retrieved successfully.
ALP_STATUS_MBL_IPC_ERROR - Communication problem between library and server.
ALP_STATUS_MBL_MEMORY_ERROR - System is out of enough memory.
ALP_STATUS_MBL_INVALID_OBJECT - The call id is not valid: the call doesn't exist.
ALP_STATUS_MBL_INVALID_PARAMETER - oIsConferenceP is NULL, and it's not valid.

Since:
ALP iSDK 1.0

alp_status_t alp_mbl_call_is_emergency ( AlpMblCallId iCallId,

bool * oIsEmergencyP

)

Check if the call is an emergency call or not.

Parameters:

[in] iCallId - Id of the call to get the emergency status.

[out] oIsEmergencyP - True if the call is an emergency one, false otherwise.

Returns:
ALP_STATUS_OK - The conference status has been retrieved successfully.
ALP_STATUS_MBL_IPC_ERROR - Communication problem between library and server.
ALP_STATUS_MBL_MEMORY_ERROR - System is out of enough memory.
ALP_STATUS_MBL_INVALID_OBJECT - The call id is not valid: the call doesn't exist.
ALP_STATUS_MBL_INVALID_PARAMETER - oIsEmergencyP is NULL, and it's not valid.

Since:
ALP iSDK 1.0

alp_status_t alp_mbl_call_is_roaming ( AlpMblCallId iCallId,

bool * oIsRoamingP

)

Check if the call is in roaming or not.

Parameters:

[in] iCallId - Id of the call to get the conference status.

[out] oIsRoamingP - True if the call is roaming, false otherwise.

Returns:
ALP_STATUS_OK - The conference status has been retrieved successfully.
ALP_STATUS_MBL_IPC_ERROR - Communication problem between library and server.
ALP_STATUS_MBL_MEMORY_ERROR - System is out of enough memory.
ALP_STATUS_MBL_INVALID_OBJECT - The call id is not valid: the call doesn't exist.
ALP_STATUS_MBL_INVALID_PARAMETER - oIsRoamingP is NULL, and it's not valid.

Since:
ALP iSDK 1.0

alp_status_t alp_mbl_call_join_call ( AlpMblCallId iCallId,

AlpMblCallId iCallIdToJoin

)

Add a call to a conference, or start a new conference.

Parameters:

[in] iCallId - A call id that will be part of the conference.

[in] iCallIdToJoin - Call id to add in the ocnference.

Returns:
ALP_STATUS_OK - The two calls has been joined successfully.
ALP_STATUS_MBL_IPC_ERROR - Communication problem between library and server.
ALP_STATUS_MBL_MEMORY_ERROR - System is out of enough memory.
ALP_STATUS_MBL_INVALID_OBJECT - Call ids are not valid: Calls don't exist or their status are not ALP_MBL_CALL_STATUS_ACTIVE or ALP_MBL_CALL_STATUS_ON_HOLD.

Since:
ALP iSDK 1.0

alp_status_t alp_mbl_call_private_call ( AlpMblCallId iCallId )

Remove a call from a conference. The conference will be put on hold, and the removed call will be active.

Parameters:

[in] iCallId - Id of the call to exclude from a conference.

Returns:
ALP_STATUS_OK - The call has been excluded successfully.
ALP_STATUS_MBL_IPC_ERROR - Communication problem between library and server.
ALP_STATUS_MBL_MEMORY_ERROR - System is out of enough memory.
ALP_STATUS_MBL_INVALID_OBJECT - The call id is not valid: the call doesn't exist, or the call is not in a conference.

Since:
ALP iSDK 1.0

alp_status_t alp_mbl_call_reject ( AlpMblCallId iCallId )

Reject a call. Only a call in ALP_MBL_CALL_STATUS_INCOMING or ALP_MBL_CALL_STATUS_WAITING state could be rejected.

Parameters:

[in] iCallId - Id of the call to reject.

Returns:
ALP_STATUS_OK - The call has been rejected successfully.
ALP_STATUS_MBL_IPC_ERROR - Communication problem between library and server.
ALP_STATUS_MBL_MEMORY_ERROR - System is out of enough memory.
ALP_STATUS_MBL_INVALID_OBJECT - The call id is not valid: the call doesn't exist or its status is not ALP_MBL_CALL_STATUS_INCOMING or ALP_MBL_CALL_STATUS_WAITING.

Since:
ALP iSDK 1.0

alp_status_t alp_mbl_call_release ( AlpMblCallId iCallId )

Release a call. If the call was in a conference, only this call is released, others calls are unchanged (except if there were two calls, the remaining one is no more a conference call).

Parameters:

[in] iCallId - Id of the call to release.

Returns:
ALP_STATUS_OK - The call has been released successfully.
ALP_STATUS_MBL_IPC_ERROR - Communication problem between library and server.
ALP_STATUS_MBL_MEMORY_ERROR - System is out of enough memory.
ALP_STATUS_MBL_INVALID_OBJECT - The call id is not valid: the call doesn't exist or its status is ALP_MBL_CALL_STATUS_IDLE and we cannot release an idle call.

Since:
ALP iSDK 1.0

alp_status_t alp_mbl_call_release_conference ( AlpMblCallId iCallId )

Release all the calls in the conference, even the call id specified.

Parameters:

[in] iCallId - A call id that is present in the conference.

Returns:
ALP_STATUS_OK - The calls has been released successfully.
ALP_STATUS_MBL_IPC_ERROR - Communication problem between library and server.
ALP_STATUS_MBL_MEMORY_ERROR - System is out of enough memory.
ALP_STATUS_MBL_INVALID_OBJECT - The call id is not valid: the call doesn't exist, or the call is not in a conference.

Since:
ALP iSDK 1.0

alp_status_t alp_mbl_call_send_dtmf ( AlpMblCallId iCallId,

char * iDtmfP

)

Send some DTMF characters. We could only send DTMF to a call with status ALP_MBL_CALL_STATUS_ACTIVE.

Parameters:

[in] iCallId - Id of the call to send the DTMF.

[in] iDtmfP - A pointer to the DTMF characters to send.

Returns:
ALP_STATUS_OK - DTMF characters has been send successfully.
ALP_STATUS_MBL_IPC_ERROR - Communication problem between library and server.
ALP_STATUS_MBL_MEMORY_ERROR - System is out of enough memory.
ALP_STATUS_MBL_INVALID_OBJECT - The call id is not valid: the call doesn't exist or its status is not ALP_MBL_CALL_STATUS_ACTIVE.
ALP_STATUS_MBL_INVALID_PARAMETER - iDtmfP is NULL, and it's not valid.

Since:
ALP iSDK 1.0

alp_status_t alp_mbl_call_transfer ( AlpMblCallId iCallId,

AlpMblCallId iTransferToCallId

)

Transfer a call to another call.

Parameters:

[in] iCallId - Id of the call to transfer.

[in] iTransferToCallId - Id of the call where the iCallId will be transferred.

Returns:
ALP_STATUS_OK - The call has been transferred successfully.
ALP_STATUS_MBL_IPC_ERROR - Communication problem between library and server.
ALP_STATUS_MBL_MEMORY_ERROR - System is out of enough memory.
ALP_STATUS_MBL_INVALID_OBJECT - The call id is not valid: the call doesn't exist or its status is not valid.

Since:
ALP iSDK 1.1

alp_status_t alp_mbl_call_transfert ( AlpMblCallId iCallId,

AlpMblCallId iTransfertToCallId

)

Transfert a call to another call.

Parameters:

[in] iCallId - Id of the call to transfert.

[in] iTransfertToCallId - Id of the call where the iCallId will be transferted.

Returns:
ALP_STATUS_OK - The call has been transfered successfully.
ALP_STATUS_MBL_IPC_ERROR - Communication problem between library and server.
ALP_STATUS_MBL_MEMORY_ERROR - System is out of enough memory.
ALP_STATUS_MBL_INVALID_OBJECT - The call id is not valid: the call doesn't exist or its status is not valid.

Note:
Deprecated, use alp_mbl_call_transfer().

Since:
ALP iSDK 1.1

Generated on Wed Jul 30 07:06:42 2008 by Doxygen 1.4.6 for ALP SDK + Hiker Documentation


Data Structures
struct	_AlpMblCall
struct	_AlpMblCallHistory
struct	_AlpMblCallHistoryList
struct	_AlpMblCallList
struct	_AlpMblCallUpdateInfo
Defines
#define	ALP_MBL_CALL_ACCEPT_INFO_DEFAULT ((AlpMblCallAcceptInfo) 0)
	Default behavior to accept a call. If there is one or more active calls, they will be held and the incoming call will be accepetd. If there one or more held calls, they will remains held, and the incoming call will be accepted. If there is one or more active call and one or more held call, active calls will be released, and then the incoming call will be accepted.
#define	ALP_MBL_CALL_ACCEPT_INFO_RELEASE_ACTIVE ((AlpMblCallAcceptInfo) 1)
	If there is one or more active calls, they will be released, and then the incoming call will be accepted. If there were held call, their status remains unchanged.
#define	ALP_MBL_CALL_ACCEPT_INFO_RELEASE_HELD ((AlpMblCallAcceptInfo) 2)
	If there is one or more held calls, they will be released, and then the incoming call will be accepted. If there were active call, they will be put on hold.
#define	ALP_MBL_CALL_DIRECTION_INCOMING ((AlpMblCallDirection) 2)
	Incoming call: Mobile terminated call, from the Network to the Teminal.
#define	ALP_MBL_CALL_DIRECTION_OUTGOING ((AlpMblCallDirection) 1)
	Outgoing call: Mobile originated call, from the Terminal to the Network.
#define	ALP_MBL_CALL_ERROR_ACTION_REQUESTED_BY_CALL_CONTROL ((AlpMblCallError) 12)
	The call is allowed with modifications.
#define	ALP_MBL_CALL_ERROR_BARRED ((AlpMblCallError) 15)
	Call has been barred by network.
#define	ALP_MBL_CALL_ERROR_BLOCKED ((AlpMblCallError) 10)
	The call has been blocked due to restriction list.
#define	ALP_MBL_CALL_ERROR_BUSY ((AlpMblCallError) 2)
	Call is busy.
#define	ALP_MBL_CALL_ERROR_COST_LIMIT ((AlpMblCallError) 14)
	Call failed due to cost limit reached.
#define	ALP_MBL_CALL_ERROR_NO_CARRIER ((AlpMblCallError) 3)
	There is no carrier.
#define	ALP_MBL_CALL_ERROR_NO_CARRIER_EMERGENCY_ONLY ((AlpMblCallError) 8)
	There is no carrier, except for emergency call.
#define	ALP_MBL_CALL_ERROR_NO_ERROR ((AlpMblCallError) 0)
	No call error.
#define	ALP_MBL_CALL_ERROR_NOT_ALLOWED ((AlpMblCallError) 4)
	Operation on this call is not allowed.
#define	ALP_MBL_CALL_ERROR_NOT_ALLOWED_BY_CALL_CONTROL ((AlpMblCallError) 11)
	The call is not allowed by Call Control.
#define	ALP_MBL_CALL_ERROR_NOT_SUPPORTED ((AlpMblCallError) 7)
	This type of call is not supported.
#define	ALP_MBL_CALL_ERROR_NWK_UNABLE_TO_PROCESS_COMMAND ((AlpMblCallError) 13)
	Call has been released because the network is unable to process the cmd.
#define	ALP_MBL_CALL_ERROR_RELEASE_BY_PEER ((AlpMblCallError) 5)
	Call has been released by the peer.
#define	ALP_MBL_CALL_ERROR_RELEASE_BY_USER ((AlpMblCallError) 6)
	Call has been released by the user.
#define	ALP_MBL_CALL_ERROR_SS_DETECTED ((AlpMblCallError) 9)
	The dial string is a Supplementary Services.
#define	ALP_MBL_CALL_ERROR_UNKNOWN ((AlpMblCallError) 1)
	Unknow call error.
#define	ALP_MBL_CALL_FILTER_ACTIVE ((AlpMblCallFilter) 2)
	All active calls.
#define	ALP_MBL_CALL_FILTER_ALL ((AlpMblCallFilter) 1)
	All calls.
#define	ALP_MBL_CALL_FILTER_ON_HOLD ((AlpMblCallFilter) 3)
	All hold calls.
#define	ALP_MBL_CALL_HISTORY_TYPE_ALL ((AlpMblCallHistoryType) 0)
	All calls.
#define	ALP_MBL_CALL_HISTORY_TYPE_DIALED ((AlpMblCallHistoryType) 3)
	All dialed calls.
#define	ALP_MBL_CALL_HISTORY_TYPE_MISSED ((AlpMblCallHistoryType) 1)
	All missed calls.
#define	ALP_MBL_CALL_HISTORY_TYPE_RECEIVED ((AlpMblCallHistoryType) 2)
	All received calls.
#define	ALP_MBL_CALL_HISTORY_TYPE_RECENT ((AlpMblCallHistoryType) 4)
	All recent calls: dialed called, without duplicate.
#define	ALP_MBL_CALL_IN_MULTIPARTY_CONFERENCE true
	Call is part of a multi-party conference group.
#define	ALP_MBL_CALL_INFO_CALL_CONFERENCE_BY_REMOTE ((AlpMblCallInfo) 6)
	A call has been add into a conference by remote.
#define	ALP_MBL_CALL_INFO_CALL_HOLD_BY_REMOTE ((AlpMblCallInfo) 4)
	A call has been put on hold by remote.
#define	ALP_MBL_CALL_INFO_CALL_RESUMED_BY_REMOTE ((AlpMblCallInfo) 5)
	A call has been resumed by remote.
#define	ALP_MBL_CALL_INFO_MO_CALL_FORWARDED ((AlpMblCallInfo) 2)
	MO call: the outgoing call is forwarded.
#define	ALP_MBL_CALL_INFO_MO_CALL_IS_WAITING ((AlpMblCallInfo) 1)
	MO call: the outgoing call is waiting on remote side.
#define	ALP_MBL_CALL_INFO_MT_CALL_FORWARDED ((AlpMblCallInfo) 3)
	MT call: the incoming call is a forwarded call.
#define	ALP_MBL_CALL_INFO_NO_EXTRA_INFO ((AlpMblCallInfo) 0)
	No extra information.
#define	ALP_MBL_CALL_NOT_IN_MULTIPARTY_CONFERENCE false
	Call is not part of a multi-party conference group.
#define	ALP_MBL_CALL_NOTIFICATION_ADDRESS_AVAILABLE ((AlpMblNotificationId) 2)
	The Address information of a call is available.
#define	ALP_MBL_CALL_NOTIFICATION_CALL_ERROR ((AlpMblNotificationId) 4)
	A call error occurs.
#define	ALP_MBL_CALL_NOTIFICATION_CCBS_POSSIBLE ((AlpMblNotificationId) 6)
	Calling party is busy, and call completion of busy subscriber is possible.
#define	ALP_MBL_CALL_NOTIFICATION_CONTACT_AVAILABLE ((AlpMblNotificationId) 3)
	The Contact information of a call is available.
#define	ALP_MBL_CALL_NOTIFICATION_COST_CHANGE ((AlpMblNotificationId) 5)
	The cost of a call has changed.
#define	ALP_MBL_CALL_NOTIFICATION_STATUS_CHANGE ((AlpMblNotificationId) 1)
	The status of a call has changed.
#define	ALP_MBL_CALL_STATUS_ACTIVE ((AlpMblCallStatus) 2)
	Call is active.
#define	ALP_MBL_CALL_STATUS_ALERTING ((AlpMblCallStatus) 5)
	Alerting in progress.
#define	ALP_MBL_CALL_STATUS_DIALING ((AlpMblCallStatus) 4)
	Dialling in progress.
#define	ALP_MBL_CALL_STATUS_IDLE ((AlpMblCallStatus) 1)
	Idle state.
#define	ALP_MBL_CALL_STATUS_INCOMING ((AlpMblCallStatus) 6)
	Incoming call.
#define	ALP_MBL_CALL_STATUS_ON_HOLD ((AlpMblCallStatus) 3)
	Call is on hold.
#define	ALP_MBL_CALL_STATUS_RELEASED ((AlpMblCallStatus) 8)
	Call is released.
#define	ALP_MBL_CALL_STATUS_WAITING ((AlpMblCallStatus) 7)
	Waiting call.
#define	ALP_MBL_CALL_TYPE_VIDEO ((AlpMblCallType) 1)
	Video telephony call.
#define	ALP_MBL_CALL_TYPE_VOICE ((AlpMblCallType) 0)
	Voice only call.
Typedefs
typedef _AlpMblCall	AlpMblCall
typedef unsigned char	AlpMblCallAcceptInfo
	Info on the way to accept a call. See ALP_MBL_CALL_ACCEPT_INFO_XXX defines.
typedef void(*	AlpMblCallAddressAvailableCallbackPtr )(void *iUserDataP, AlpMblCallId iCallId, AlpMblAddress iAddress)
typedef void(*	AlpMblCallCCBSPossibleCallbackPtr )(void *iUserDataP, AlpMblCallId iCallId)
typedef void(*	AlpMblCallContactAvailableCallbackPtr )(void *iUserDataP, AlpMblCallId iCallId, AlpLuid iPersonLuid, AlpLuid iContactLuid)
typedef void(*	AlpMblCallCostChangeCallbackPtr )(void *iUserDataP, AlpMblCallId iCallId, AlpMblCost iPrevious, AlpMblCost iCurrent)
typedef unsigned long	AlpMblCallDate
	Call date: number of seconds since January 1, 1970.
typedef unsigned char	AlpMblCallDirection
typedef unsigned long	AlpMblCallDuration
	Call duration, in seconds.
typedef unsigned char	AlpMblCallError
	Call error: see ALP_MBL_CALL_XXX defines.
typedef void(*	AlpMblCallErrorCallbackPtr )(void *iUserDataP, AlpMblAddress iCallAddress, AlpLuid iPersonLuid, AlpMblCallError iCallError)
typedef unsigned char	AlpMblCallFilter
typedef _AlpMblCallHistory	AlpMblCallHistory
typedef _AlpMblCallHistoryList	AlpMblCallHistoryList
typedef unsigned char	AlpMblCallHistoryType
	Type of call history.
typedef unsigned short	AlpMblCallId
typedef unsigned char	AlpMblCallInfo
	Call extra information: see ALP_MBL_CALL_INFO_XXX defines.
typedef _AlpMblCallList	AlpMblCallList
typedef char	AlpMblCallName [64]
typedef unsigned char	AlpMblCallStatus
typedef void(*	AlpMblCallStatusChangeCallbackPtr )(void *iUserDataP, AlpMblCallId iCallId, AlpMblCallStatus iPrevious, AlpMblCallStatus iCurrent, bool iConferenceStatus, AlpMblCallError iCallError, AlpMblCallType iCallType, AlpMblCallInfo iCallInfo)
typedef char	AlpMblCallThumbnailUri [128]
typedef unsigned char	AlpMblCallType
	Type of call: voice only or video telephony call.
typedef _AlpMblCallUpdateInfo	AlpMblCallUpdateInfo
Functions
alp_status_t	alp_mbl_call_accept (AlpMblCallId iCallId, AlpMblCallAcceptInfo iAcceptInfo)
alp_status_t	alp_mbl_call_activate_completion_to_busy_subscriber (AlpMblCallId iCallId)
alp_status_t	alp_mbl_call_deflect (AlpMblCallId iCallId, AlpMblAddress iAddress)
alp_status_t	alp_mbl_call_dial (AlpMblCallId iCallId)
alp_status_t	alp_mbl_call_dial_dtmf (AlpMblCallId iCallId, char *iDtmfP)
alp_status_t	alp_mbl_call_exclude_call (AlpMblCallId iCallId)
alp_status_t	alp_mbl_call_get (AlpMblCallId iCallId, AlpMblCall *oCallP)
alp_status_t	alp_mbl_call_get_address (AlpMblCallId iCallId, AlpMblAddress *oAddressP)
alp_status_t	alp_mbl_call_get_conference (AlpMblCallId iCallId, AlpMblCallList *oCallListP)
alp_status_t	alp_mbl_call_get_context_id (AlpMblCallId iCallId, AlpMblContextId *oContextIdP)
alp_status_t	alp_mbl_call_get_cost (AlpMblCallId iCallId, AlpMblCost *oCostP)
alp_status_t	alp_mbl_call_get_date (AlpMblCallId iCallId, AlpMblCallDate *oDateP)
alp_status_t	alp_mbl_call_get_direction (AlpMblCallId iCallId, AlpMblCallDirection *oDirectionP)
alp_status_t	alp_mbl_call_get_duration (AlpMblCallId iCallId, AlpMblCallDuration *oDurationP)
alp_status_t	alp_mbl_call_get_info (AlpMblCallId iCallId, AlpMblCallInfo *oInfoP)
alp_status_t	alp_mbl_call_get_line_id (AlpMblCallId iCallId, AlpMblLineId *oLineIdP)
alp_status_t	alp_mbl_call_get_luid (AlpMblCallId iCallId, AlpLuid *oPersonLuidP) __attribute((deprecated))
alp_status_t	alp_mbl_call_get_luids (AlpMblCallId iCallId, AlpLuid oPersonLuidP, AlpLuid oContactLuidP)
alp_status_t	alp_mbl_call_get_name (AlpMblCallId iCallId, AlpMblCallName *oNameP)
alp_status_t	alp_mbl_call_get_status (AlpMblCallId iCallId, AlpMblCallStatus *oStatusP)
alp_status_t	alp_mbl_call_get_thumbnail (AlpMblCallId iCallId, AlpMblCallThumbnailUri *oThumbnailUriP)
alp_status_t	alp_mbl_call_get_type (AlpMblCallId iCallId, AlpMblCallType *oTypeP)
alp_status_t	alp_mbl_call_hold (AlpMblCallId iCallId)
alp_status_t	alp_mbl_call_is_conference (AlpMblCallId iCallId, bool *oIsConferenceP)
alp_status_t	alp_mbl_call_is_emergency (AlpMblCallId iCallId, bool *oIsEmergencyP)
alp_status_t	alp_mbl_call_is_roaming (AlpMblCallId iCallId, bool *oIsRoamingP)
alp_status_t	alp_mbl_call_join_call (AlpMblCallId iCallId, AlpMblCallId iCallIdToJoin)
alp_status_t	alp_mbl_call_private_call (AlpMblCallId iCallId)
alp_status_t	alp_mbl_call_reject (AlpMblCallId iCallId)
alp_status_t	alp_mbl_call_release (AlpMblCallId iCallId)
alp_status_t	alp_mbl_call_release_conference (AlpMblCallId iCallId)
alp_status_t	alp_mbl_call_send_dtmf (AlpMblCallId iCallId, char *iDtmfP)
alp_status_t	alp_mbl_call_transfer (AlpMblCallId iCallId, AlpMblCallId iTransferToCallId)
alp_status_t	alp_mbl_call_transfert (AlpMblCallId iCallId, AlpMblCallId iTransfertToCallId) __attribute((deprecated))

Call Service [Mobile Services]

Detailed Description

Data Structures

Defines

Typedefs

Functions

Define Documentation

Typedef Documentation

Function Documentation

Call Service
[Mobile Services]