Mobile Service
[Mobile Services]

Detailed Description

This service groups the Mobile functions.

Functions in this group are not related to a specific context. A mobile could have multiple context. But only one could be the default context. And if the default one is deleted, a new one is selected, except if there is no more context. In a cellular phone, the default context will be the one related to the phone module. If the device has more than one phone module, the default context could change according to the user. If the device also support VoIP, a VoIP Context could never be a default context, the default context will always be a cellular context. In a VoIP phone, the default context will be handled by the user.


Defines

#define ALP_MBL_NOTIFICATION_CALL_HISTORY_CHANGE   ((AlpMblNotificationId) 4)
 There has been a change in the call history database.
#define ALP_MBL_NOTIFICATION_CALL_HISTORY_RESET   ((AlpMblNotificationId) 5)
 The call history database has been reseted.
#define ALP_MBL_NOTIFICATION_CONTEXT_DELETE   ((AlpMblNotificationId) 2)
 A mobile context has been removed.
#define ALP_MBL_NOTIFICATION_DEFAULT_CONTEXT_CHANGE   ((AlpMblNotificationId) 3)
 The Default mobile context has changed.
#define ALP_MBL_NOTIFICATION_FUNCTION_TERMINATE   ((AlpMblNotificationId) 6)
 A function of the Mobile Services has finished.
#define ALP_MBL_NOTIFICATION_NEW_CONTEXT   ((AlpMblNotificationId) 1)
 A mobile context has been registered.

Typedefs

typedef void(* AlpMblCallFunctionTerminateCallbackPtr )(void *iUserDataP, AlpMblServiceId iServiceId, AlpMblFunctionId iFunctionId, alp_status_t iError)
typedef void(* AlpMblCallHistoryChangeCallbackPtr )(void *iUserDataP, AlpMblCallHistory *iCallHistoryP, bool iRemoveF)
typedef void(* AlpMblCallHistoryResetCallbackPtr )(void *iUserDataP, AlpMblCallHistoryType iCallHistoryType)
typedef void(* AlpMblContextDeleteCallbackPtr )(void *iUserDataP, AlpMblContextId iMobileContextId)
typedef void(* AlpMblDefaultContextChangeCallbackPtr )(void *iUserDataP, AlpMblContextId iPreviousDefaultContextId, AlpMblContextId iNewDefaultContextId)
typedef void(* AlpMblNewContextCallbackPtr )(void *iUserDataP, AlpMblContextId iMobileContextId)

Functions

alp_status_t alp_mbl_add_observers (void *iContextP, AlpMblObserver iObservers[])
bool alp_mbl_compare_phone_numbers (AlpMblAddress iPhoneNumber1, AlpMblAddress iPhoneNumber2)
void alp_mbl_free (void *iPtrP)
alp_status_t alp_mbl_get_call_history (AlpMblCallHistoryType iCallHistoryType, uint32_t iFirstId, uint32_t iLastId, AlpMblCallHistoryList *oCallHistoryListP)
alp_status_t alp_mbl_get_call_history_count (AlpMblCallHistoryType iCallHistoryType, uint32_t *oCallHistoryCountP)
alp_status_t alp_mbl_get_contexts (AlpMblContextList *oContextListP)
alp_status_t alp_mbl_get_current_calls (AlpMblCallList *oCallListP, AlpMblCallFilter iFilter)
alp_status_t alp_mbl_get_default_context (AlpMblContextId *oDefaultContextIdP)
alp_status_t alp_mbl_get_last_call_info (AlpMblCallHistory *oCallInfoP)
alp_status_t alp_mbl_new_context_cellular (AlpMblCncProfileId iCncProfileId, bool iIsDefault, bool iStartAtBoot, bool iAlwaysOn, AlpMblContextId *oContextIdP)
alp_status_t alp_mbl_new_context_gsm (AlpMblCncProfileId iCncProfileId, bool iIsDefault, bool iStartAtBoot, AlpMblContextId *oContextIdP) __attribute((deprecated))
alp_status_t alp_mbl_remove_call_history (AlpMblCallHistoryType iCallHistoryType, uint32_t iId)
alp_status_t alp_mbl_remove_observers (void *iContextP, AlpMblObserver iObservers[])
alp_status_t alp_mbl_reset_call_history (AlpMblCallHistoryType iCallHistoryType)
alp_status_t alp_mbl_set_default_context (AlpMblContextId iDefaultContextId)

Define Documentation

#define ALP_MBL_NOTIFICATION_CALL_HISTORY_CHANGE   ((AlpMblNotificationId) 4)
 

There has been a change in the call history database.

#define ALP_MBL_NOTIFICATION_CALL_HISTORY_RESET   ((AlpMblNotificationId) 5)
 

The call history database has been reseted.

#define ALP_MBL_NOTIFICATION_CONTEXT_DELETE   ((AlpMblNotificationId) 2)
 

A mobile context has been removed.

#define ALP_MBL_NOTIFICATION_DEFAULT_CONTEXT_CHANGE   ((AlpMblNotificationId) 3)
 

The Default mobile context has changed.

#define ALP_MBL_NOTIFICATION_FUNCTION_TERMINATE   ((AlpMblNotificationId) 6)
 

A function of the Mobile Services has finished.

#define ALP_MBL_NOTIFICATION_NEW_CONTEXT   ((AlpMblNotificationId) 1)
 

A mobile context has been registered.

Typedef Documentation

typedef void(* AlpMblCallFunctionTerminateCallbackPtr)(void *iUserDataP, AlpMblServiceId iServiceId, AlpMblFunctionId iFunctionId, alp_status_t iError)
 

Callback prototype for ALP_MBL_NOTIFICATION_FUNCTION_TERMINATE notification.

Parameters:
[in] iUserDataP - A pointer to user data info, given with the alp_mbl_add_observers() function call.
[in] iServiceId - The service id of the terminated function.
[in] iFunctionId - The function id of the terminated function.
[in] iError - The error code of the terminated function. For CALL service, the error is not an alp_status_t, but an AlpMblCallError

typedef void(* AlpMblCallHistoryChangeCallbackPtr)(void *iUserDataP, AlpMblCallHistory *iCallHistoryP, bool iRemoveF)
 

Callback prototype for ALP_MBL_NOTIFICATION_CALL_HISTORY_CHANGE notification.

Parameters:
[in] iUserDataP - A pointer to user data info, given with the alp_mbl_add_observers() function call.
[in] iCallHistoryP - A pointer to an AlpMblCallHistory, with the call history info. If NULL, multiple entries have changed, application should refresh the entire log.
[in] iRemoveF - A flag that indicates if the call history has been added or deleted.
Note:
It's up to the application to free the iCallHistoryP when it no longer need it, using the alp_mbl_free() API.

typedef void(* AlpMblCallHistoryResetCallbackPtr)(void *iUserDataP, AlpMblCallHistoryType iCallHistoryType)
 

Callback prototype for ALP_MBL_NOTIFICATION_CALL_HISTORY_RESET notification.

Parameters:
[in] iUserDataP - A pointer to user data info, given with the alp_mbl_add_observers() function call.
[in] iCallHistoryType - The type of history call that has been reseted.

typedef void(* AlpMblContextDeleteCallbackPtr)(void *iUserDataP, AlpMblContextId iMobileContextId)
 

Callback prototype for ALP_MBL_NOTIFICATION_CONTEXT_DELETE notification.

Parameters:
[in] iUserDataP - A pointer to user data info, given with the alp_mbl_add_observers() function call.
[in] iMobileContextId - The id of the mobile context that has been deleted.

typedef void(* AlpMblDefaultContextChangeCallbackPtr)(void *iUserDataP, AlpMblContextId iPreviousDefaultContextId, AlpMblContextId iNewDefaultContextId)
 

Callback prototype for ALP_MBL_NOTIFICATION_DEFAULT_CONTEXT_CHANGE notification.

Parameters:
[in] iUserDataP - A pointer to user data info, given with the alp_mbl_add_observers() function call.
[in] iPreviousDefaultContextId - The id of the previous default mobile context.
[in] iNewDefaultContextId - The id of the new default mobile context.

typedef void(* AlpMblNewContextCallbackPtr)(void *iUserDataP, AlpMblContextId iMobileContextId)
 

Callback prototype for ALP_MBL_NOTIFICATION_NEW_CONTEXT notification.

Parameters:
[in] iUserDataP - A pointer to user data info, given with the alp_mbl_add_observers() function call.
[in] iMobileContextId - The id of the mobile context that has been add.

Function Documentation

alp_status_t alp_mbl_add_observers (  void *  iContextP,
AlpMblObserver  iObservers[]
) 
 

Add some observers

Parameters:
[in] iContextP - A GMainContext pointer (to be handled in the main event loop).
[in] iObservers - The observers to add.
Returns:
ALP_STATUS_OK - Observer added successfully.

ALP_STATUS_MBL_INVALID_PARAMETER - If the Service Id or the Notification id is invalid.

Example:
Example of use: 
#include <stdio.h>
#include <alp/mobile.h>
#include <alp/mobile_network.h>
#include <alp/errormgr.h>

void prv_new_context_callback(void* iUserDataP, AlpMblContextId iMobileContextId)
{
        printf("New mobile context registered with id %d.\n", iMobileContextId);
}

void prv_network_status_change(void* iUserDataP, AlpMblNetworkId iNetworkId, AlpMblNetworkStatus iPrevious, AlpMblNetworkStatus iCurrent, AlpMblNetworkAccessTechnology iAccessTechnology, AlpMblNetworkDeniedInformation iDeniedInformation)
{
        printf("Network status change for network id %d.\n", iNetworkId);
}

alp_status_t prv_register_observers()
{
        AlpMblObserver  myObservers[3];
        alp_status_t    err;

        myObservers[0].serviceId                = ALP_MBL_MOBILE_SERVICE_ID;
        myObservers[0].notificationId   = ALP_MBL_NOTIFICATION_NEW_CONTEXT;
        myObservers[0].callbackP                = prv_new_context_callback;
        myObservers[0].userDataP                = NULL;

        myObservers[1].serviceId                = ALP_MBL_NETWORK_SERVICE_ID;
        myObservers[1].notificationId   = ALP_MBL_NETWORK_NOTIFICATION_STATUS_CHANGE;
        myObservers[1].callbackP                = prv_network_status_change;
        myObservers[1].userDataP                = NULL;

        myObservers[2].serviceId                = ALP_MBL_NO_SERVICE_ID;

        if ((err = alp_mbl_add_observers(NULL, myObservers)) != ALP_STATUS_OK)
        {
                printf("alp_mbl_add_observers failed with error: %s.\n", alp_err_get_string(err, true));
                return err;
        }

        return ALP_STATUS_OK;
}
Since:
ALP iSDK 1.0

bool alp_mbl_compare_phone_numbers (  AlpMblAddress  iPhoneNumber1,
AlpMblAddress  iPhoneNumber2
) 
 

Compare two phone numbers.

Parameters:
[in] iPhoneNumber1 - First number to compare.
[in] iPhoneNumber2 - Second number to compare.
Returns:
true - If phone number are matching.

false - If phone numbers are not matching.

Since:
ALP iSDK 2.3

void alp_mbl_free (  void *  iPtrP  ) 
 

Free a memory block that has been allocated by the Mobile Services.

Parameters:
[in] iPtrP - A pointer to the memory block to free. iPtrP could be NULL, and in this case nothing is done.
Example:
You can see an example of use with the description of the function alp_mbl_get_contexts().
Since:
ALP iSDK 1.0

alp_status_t alp_mbl_get_call_history (  AlpMblCallHistoryType  iCallHistoryType,
uint32_t  iFirstId,
uint32_t  iLastId,
AlpMblCallHistoryList *  oCallHistoryListP
) 
 

Retrieve call history. The Mobile Services will allocate the memory to fit with the appropriate call history count. It will be the responsability of the application to free the memory using the alp_mbl_free() API. If there is no call history, alp_mbl_get_call_history will return ALP_STATUS_OK, oCallHistoryListP->callHistoryCount will be 0, and oHistoryCallsListP->callHistoryP will be NULL.

Parameters:
[in] iCallHistoryType - Type of history call to get. See defines ALP_MBL_CALL_HISTORY_TYPE_XXX.
[in] iFirstId - First index to retrieve, 0-based.
[in] iLastId - Last index to retrieve, 0-based.
[out] oCallHistoryListP - A pointer to an AlpMblCallHistoryList, that will have the list of history calls.
Returns:
ALP_STATUS_OK - If successfull.

ALP_STATUS_MBL_IPC_ERROR - Communication problem between library and server.

ALP_STATUS_MBL_MEMORY_ERROR - System is out of enough memory.

Example:
An example of retrieving the list of call history. 
#include <stdio.h>
#include <alp/mobile.h>
#include <alp/errormgr.h>
alp_status_t prv_display_call_log()
{
        AlpMblCallHistoryList   callHistoryList;
        uint32_t                                i;
        alp_status_t                    err;

        if ((err = alp_mbl_get_call_history(ALP_MBL_CALL_HISTORY_TYPE_ALL, 0, 9, &callHistoryList)) != ALP_STATUS_OK)
        {
                printf("alp_mbl_get_call_history failed with error: %s.\n", alp_err_get_string(err, true));
                return err;
        }

        printf("Found (%lu) call history.\n", callHistoryList.callHistoryCount);

        for ( i = 0 ; i < callHistoryList.callHistoryCount ; i++ )
        {
                printf("Call number <%s>.\n", callHistoryList.callHistoryP[i].address);
        }

        alp_mbl_free(callHistoryList.callHistoryP);

        return ALP_STATUS_OK;
}
Since:
ALP iSDK 1.0

alp_status_t alp_mbl_get_call_history_count (  AlpMblCallHistoryType  iCallHistoryType,
uint32_t *  oCallHistoryCountP
) 
 

Retrieve the count of call history.

Parameters:
[in] iCallHistoryType - Type of call history to get the count.
[out] oCallHistoryCountP - A pointer to an uint32_t that will have the call history count uppon return.
Returns:
ALP_STATUS_OK - If successfull.

ALP_STATUS_MBL_IPC_ERROR - Communication problem between library and server.

ALP_STATUS_MBL_MEMORY_ERROR - System is out of enough memory.

Since:
ALP iSDK 1.0

alp_status_t alp_mbl_get_contexts (  AlpMblContextList *  oContextListP  ) 
 

Get the registered mobile context(s). The Mobile Services will allocate the memory to fit with the appropriate context count. It will be the responsability of the application to free the memory using the alp_mbl_free() API. If there is no mobile context registered, alp_mbl_get_contexts will return ALP_STATUS_OK, oContextListP->contextIdCount will be 0, and oContextListP->contextIdListP will be NULL.

Parameters:
[out] oContextListP - A pointer to an AlpMblContextList, that will have the list of registered mobile context id.
Returns:
ALP_STATUS_OK - If successfull.

ALP_STATUS_MBL_IPC_ERROR - Communication problem between library and server.

ALP_STATUS_MBL_MEMORY_ERROR - System is out of enough memory.

Example:
An example of retrieving the list of registered mobile contexts, and getting their description. 
#include <stdio.h>
#include <alp/mobile.h>
#include <alp/errormgr.h>

alp_status_t prv_list_mobile_contexts()
{
        AlpMblContextList                       contextList;
        AlpMblContextDescription        contextDescription;
        unsigned short                          i;
        alp_status_t                            err;

        if ((err = alp_mbl_get_contexts(&contextList)) != ALP_STATUS_OK)
        {
                printf("alp_mbl_get_contexts failed with error: %s.\n", alp_err_get_string(err, true));
                return err;
        }

        printf("We have found %d mobile context(s).\n", contextList.contextIdCount);

        for ( i = 0 ; i < contextList.contextIdCount ; i++ )
        {
                if ((err = alp_mbl_context_get_description(contextList.contextIdListP[i], &contextDescription)) != ALP_STATUS_OK)
                {
                        printf("alp_mbl_context_get_description failed with error: %s.\n", alp_err_get_string(err, true));
                        goto cleanup;
                }

                printf("Mobile context %d description: '%s'.\n", i, contextDescription);
        }

cleanup:
        alp_mbl_free(contextList.contextIdListP);

        return err;
}
Since:
ALP iSDK 1.0

alp_status_t alp_mbl_get_current_calls (  AlpMblCallList *  oCallListP,
AlpMblCallFilter  iFilter
) 
 

Get the current calls list, for all registered context

Parameters:
[in] iFilter - (ALP_MBL_CALL_FILTER_ALL or ALP_MBL_CALL_FILTER_ACTIVE or ALP_MBL_CALL_FILTER_ON_HOLD)
[out] oCallListP - is the call list pointer.
Returns:
ALP_STATUS_OK - If successfull.

ALP_STATUS_MBL_IPC_ERROR - Communication problem between library and server.

ALP_STATUS_MBL_MEMORY_ERROR - System is out of enough memory.

Example:
An example of retrieving the list of current calls, and getting their addresses. 
#include <stdio.h>
#include <alp/mobile.h>
#include <alp/errormgr.h>

alp_status_t prv_list_current_calls()
{
        AlpMblCallList  callList;
        AlpMblAddress   callAddress;
        uint8_t                 i;
        alp_status_t    err;

        if ((err = alp_mbl_get_current_calls(&callList, ALP_MBL_CALL_FILTER_ALL)) != ALP_STATUS_OK)
        {
                printf("alp_mbl_get_current_calls failed with error: %s.\n", alp_err_get_string(err, true));
                return err;
        }

        printf("There is (are) %d current call(s).\n", callList.callCount);

        for ( i = 0 ; i < callList.callCount ; i++ )
        {
                if ((err = alp_mbl_call_get_address(callList.callIdListP[i], &callAddress)) != ALP_STATUS_OK)
                {
                        printf("alp_mbl_call_get_address failed with error: %s.\n", alp_err_get_string(err, true));
                        goto cleanup;
                }

                printf("Call %d, address: '%s'.\n", i, callAddress);
        }

cleanup:
        alp_mbl_free(callList.callIdListP);

        return err;
}
Since:
ALP iSDK 1.0

alp_status_t alp_mbl_get_default_context (  AlpMblContextId *  oDefaultContextIdP  ) 
 

Return the default mobile context id. If there is no default context, alp_mbl_get_default_context() will return ALP_STATUS_OK, and *oDefaultContextIdP will be ALP_MBL_CONTEXT_INVALID_CONTEXT_ID.

Parameters:
[out] oDefaultContextIdP - A pointer to an AlpMblContextId that will receive the default mobile context id.
Returns:
ALP_STATUS_OK - If successfull.

ALP_STATUS_MBL_IPC_ERROR - Communication problem between library and server.

ALP_STATUS_MBL_MEMORY_ERROR - System is out of enough memory.

Example:
You can see an example of use with the description of the function alp_mbl_context_get_status().
Since:
ALP iSDK 1.0

alp_status_t alp_mbl_get_last_call_info (  AlpMblCallHistory *  oCallInfoP  ) 
 

Get info on the last call.

Parameters:
[out] oCallInfoP - Pointer to an AlpMblCallHistory to store upon return the information of the last call.
Returns:
ALP_STATUS_OK - If successfull.

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_PARAMETER - oCallInfoP is NULL and this is not valid.

ALP_STATUS_MBL_VALUE_NOT_AVAILABLE - There is no last call.

Since:
ALP iSDK 2.5

alp_status_t alp_mbl_new_context_cellular (  AlpMblCncProfileId  iCncProfileId,
bool  iIsDefault,
bool  iStartAtBoot,
bool  iAlwaysOn,
AlpMblContextId *  oContextIdP
) 
 

Register a Cellular Mobile Context to the Mobile Services

Parameters:
[in] iCncProfileId - The Telephony Cnc Profile to use with this mobile context.
[in] iIsDefault - Set it to true to set this new mobile context as the default mobile context, false to not.
[in] iStartAtBoot - Set it to true to start this mobile context during the boot, false to not.
[in] iAlwaysOn - Set it to true to never stop this mobile context, only the radio will be turned off if this context is stopped by user.
[out] oContextIdP - A pointer to an AlpMblContextId that will receive the id of this new mobile context.
Returns:
ALP_STATUS_OK - If successfull.

ALP_STATUS_MBL_IPC_ERROR - Communication problem between library and server.

ALP_STATUS_MBL_MEMORY_ERROR - System is out of enough memory.

Since:
ALP iSDK 1.1

alp_status_t alp_mbl_new_context_gsm (  AlpMblCncProfileId  iCncProfileId,
bool  iIsDefault,
bool  iStartAtBoot,
AlpMblContextId *  oContextIdP
) 
 

Register a GSM Mobile Context to the Mobile Services

Parameters:
[in] iCncProfileId - The Telephony Cnc Profile to use with this mobile context.
[in] iIsDefault - Set it to true to set this new mobile context as the default mobile context, false to not.
[in] iStartAtBoot - Set it to true to start this mobile context during the boot, false to not.
[out] oContextIdP - A pointer to an AlpMblContextId that will receive the id of this new mobile context.
Returns:
ALP_STATUS_OK - If successfull.

ALP_STATUS_MBL_IPC_ERROR - Communication problem between library and server.

ALP_STATUS_MBL_MEMORY_ERROR - System is out of enough memory.

Note:
Deprecated since ALP iSDK 1.1, please use function alp_mbl_new_context_cellular().
Since:
ALP iSDK 1.0

alp_status_t alp_mbl_remove_call_history (  AlpMblCallHistoryType  iCallHistoryType,
uint32_t  iId
) 
 

Remove an entry in the call history database.

Parameters:
[in] iCallHistoryType - Type of call history to remove.
[in] iId - Id of the call history to remove, 0-based
Returns:
ALP_STATUS_OK - If successfull.

ALP_STATUS_MBL_IPC_ERROR - Communication problem between library and server.

ALP_STATUS_MBL_MEMORY_ERROR - System is out of enough memory.

Since:
ALP iSDK 1.0

alp_status_t alp_mbl_remove_observers (  void *  iContextP,
AlpMblObserver  iObservers[]
) 
 

Remove some observers

Parameters:
[in] iContextP - A GMainContext pointer (to be handled in the main event loop).
[in] iObservers - The observers to remove.
Returns:
ALP_STATUS_OK - Observer removed successfully.

ALP_STATUS_MBL_INVALID_PARAMETER - If the Service Id or the Notification id is invalid.

Example:
Example of use: 
#include <stdio.h>
#include <alp/mobile.h>
#include <alp/mobile_network.h>
#include <alp/errormgr.h>

void prv_new_context_callback(void* iUserDataP, AlpMblContextId iMobileContextId)
{
        printf("New mobile context registered with id %d.\n", iMobileContextId);
}

void prv_network_status_change(void* iUserDataP, AlpMblNetworkId iNetworkId, AlpMblNetworkStatus iPrevious, AlpMblNetworkStatus iCurrent, AlpMblNetworkAccessTechnology iAccessTechnology, AlpMblNetworkDeniedInformation iDeniedInformation)
{
        printf("Network status change for network id %d.\n", iNetworkId);
}

alp_status_t prv_unregister_observers()
{
        AlpMblObserver  myObservers[3];
        alp_status_t    err;

        myObservers[0].serviceId                = ALP_MBL_MOBILE_SERVICE_ID;
        myObservers[0].notificationId   = ALP_MBL_NOTIFICATION_NEW_CONTEXT;
        myObservers[0].callbackP                = prv_new_context_callback;
        myObservers[0].userDataP                = NULL;

        myObservers[1].serviceId                = ALP_MBL_NETWORK_SERVICE_ID;
        myObservers[1].notificationId   = ALP_MBL_NETWORK_NOTIFICATION_STATUS_CHANGE;
        myObservers[1].callbackP                = prv_network_status_change;
        myObservers[1].userDataP                = NULL;

        myObservers[2].serviceId                = ALP_MBL_NO_SERVICE_ID;

        if ((err = alp_mbl_remove_observers(NULL, myObservers)) != ALP_STATUS_OK)
        {
                printf("alp_mbl_remove_observers failed with error: %s.\n", alp_err_get_string(err, true));
                return err;
        }

        return ALP_STATUS_OK;
}
Since:
ALP iSDK 1.0

alp_status_t alp_mbl_reset_call_history (  AlpMblCallHistoryType  iCallHistoryType  ) 
 

Reset the call history database.

Parameters:
[in] iCallHistoryType - Type of call history to reset.
Returns:
ALP_STATUS_OK - If successfull.

ALP_STATUS_MBL_IPC_ERROR - Communication problem between library and server.

ALP_STATUS_MBL_MEMORY_ERROR - System is out of enough memory.

Since:
ALP iSDK 1.0

alp_status_t alp_mbl_set_default_context (  AlpMblContextId  iDefaultContextId  ) 
 

Set the default mobile context id.

Parameters:
[out] iDefaultContextId - The id of the Mobile Context that will be set as default mobile context.
Returns:
ALP_STATUS_OK - If successfull.

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 given mobile context id does not exist.

Since:
ALP iSDK 1.0

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

Copyright © 1999-2008 ACCESS CO., LTD. All rights reserved.