/*****************************************************************************
*  Copyright Statement:
*  --------------------
*  This software is protected by Copyright and the information contained
*  herein is confidential. The software may not be copied and the information
*  contained herein may not be used or disclosed except with the written
*  permission of MediaTek Inc. (C) 2005
*
*  BY OPENING THIS FILE, BUYER HEREBY UNEQUIVOCALLY ACKNOWLEDGES AND AGREES
*  THAT THE SOFTWARE/FIRMWARE AND ITS DOCUMENTATIONS ("MEDIATEK SOFTWARE")
*  RECEIVED FROM MEDIATEK AND/OR ITS REPRESENTATIVES ARE PROVIDED TO BUYER ON
*  AN "AS-IS" BASIS ONLY. MEDIATEK EXPRESSLY DISCLAIMS ANY AND ALL WARRANTIES,
*  EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE IMPLIED WARRANTIES OF
*  MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE OR NONINFRINGEMENT.
*  NEITHER DOES MEDIATEK PROVIDE ANY WARRANTY WHATSOEVER WITH RESPECT TO THE
*  SOFTWARE OF ANY THIRD PARTY WHICH MAY BE USED BY, INCORPORATED IN, OR
*  SUPPLIED WITH THE MEDIATEK SOFTWARE, AND BUYER AGREES TO LOOK ONLY TO SUCH
*  THIRD PARTY FOR ANY WARRANTY CLAIM RELATING THERETO. MEDIATEK SHALL ALSO
*  NOT BE RESPONSIBLE FOR ANY MEDIATEK SOFTWARE RELEASES MADE TO BUYER'S
*  SPECIFICATION OR TO CONFORM TO A PARTICULAR STANDARD OR OPEN FORUM.
*
*  BUYER'S SOLE AND EXCLUSIVE REMEDY AND MEDIATEK'S ENTIRE AND CUMULATIVE
*  LIABILITY WITH RESPECT TO THE MEDIATEK SOFTWARE RELEASED HEREUNDER WILL BE,
*  AT MEDIATEK'S OPTION, TO REVISE OR REPLACE THE MEDIATEK SOFTWARE AT ISSUE,
*  OR REFUND ANY SOFTWARE LICENSE FEES OR SERVICE CHARGE PAID BY BUYER TO
*  MEDIATEK FOR SUCH MEDIATEK SOFTWARE AT ISSUE. 
*
*  THE TRANSACTION CONTEMPLATED HEREUNDER SHALL BE CONSTRUED IN ACCORDANCE
*  WITH THE LAWS OF THE STATE OF CALIFORNIA, USA, EXCLUDING ITS CONFLICT OF
*  LAWS PRINCIPLES.  ANY DISPUTES, CONTROVERSIES OR CLAIMS ARISING THEREOF AND
*  RELATED THERETO SHALL BE SETTLED BY ARBITRATION IN SAN FRANCISCO, CA, UNDER
*  THE RULES OF THE INTERNATIONAL CHAMBER OF COMMERCE (ICC).
*
*****************************************************************************/

/*******************************************************************************
* Filename:
* ---------
*  MRESrvGProt.h
*
* Project:
* --------
*  MAUI
*
* Description:
* ------------
*  MRE external interface.
*
* Author:
* -------
 * -------
*
*==============================================================================
*             HISTORY
* Below this line, this part is controlled by PVCS VM. DO NOT MODIFY!! 
*------------------------------------------------------------------------------
*
*------------------------------------------------------------------------------
* Upper this line, this part is controlled by PVCS VM. DO NOT MODIFY!! 
*==============================================================================
*******************************************************************************/
#ifndef __MRESRVGPROT_H__
#define __MRESRVGPROT_H__

#include "MMIDataType.h"

#define SRV_MRE_APP_LOGO    "_VREApplogo30.img"
#define SRV_MRE_APP_NEW_LOGO    "Applogo.img"
#define SRV_MRE_APP_AB2_LOGO    "ApplogoAB2.img"


typedef enum
{
    SRV_MRE_CALLER_NULL,
    SRV_MRE_CALLER_SERVICE,
    SRV_MRE_CALLER_AM,
    SRV_MRE_CALLER_DOWNLOAD,
    SRV_MRE_CALLER_END_OF_ENUM
} srv_mre_load_core_caller_enum;

typedef enum
{
    SRV_MRE_LOAD_CORE_SUCCESS = 0,
    SRV_MRE_LOAD_CORE_ASYN_ALLOC_ASM,
    SRV_MRE_LOAD_CORE_MASS_STORAGE,
    SRV_MRE_LOAD_CORE_INTERNEL_ERROR,
    SRV_MRE_LOAD_CORE_END_OF_ENUM
} srv_mre_load_core_result_enum;

typedef enum
{
    SRV_MRE_LOAD_CORE_EVT_SUCCESS = 0,
    SRV_MRE_LOAD_CORE_EVT_INTERNAL_ERROR,
    SRV_MRE_LOAD_CORE_EVT_QUIT,
    SRV_MRE_LOAD_CORE_EVT_END_OF_ENUM
} srv_mre_load_core_evt_enum;

typedef enum
{
    SRV_MRE_LAUNCH_APP_EVT_SUCCESS = 0,
    SRV_MRE_LAUNCH_APP_ASM_READY,
    SRV_MRE_LAUNCH_APP_EVT_INTERNEL_ERROR,
    SRV_MRE_LAUNCH_APP_EVT_QUIT,
    SRV_MRE_LAUNCH_APP_EVT_END_OF_ENUM
} srv_mre_launch_app_evt_enum;

typedef void (*srv_mre_load_core_cb_t) (srv_mre_load_core_evt_enum evt);
typedef void (*srv_mre_launch_app_cb_t) (U16 *app_path, srv_mre_launch_app_evt_enum evt);

/* App start result */
typedef enum
{
    SRV_MRE_LAUNCH_APP_SUCCESS = 0,
    SRV_MRE_LAUNCH_APP_ILLEGAL,
    SRV_MRE_LAUNCH_APP_NOT_ENOUGH_MEMORY,
    SRV_MRE_LAUNCH_APP_CALL_STACK_FULL,
    SRV_MRE_LAUNCH_APP_INTERNAL_ERROR,
    SRV_MRE_LAUNCH_APP_PLATFORM_PARAM_DISMATCH,
    SRV_MRE_LAUNCH_APP_TIMESTAMP_ERROR,
    SRV_MRE_LAUNCH_APP_BANNED_APP,
    SRV_MRE_LAUNCH_APP_IMSI_DISMATCH,
    SRV_MRE_LAUNCH_APP_CERT_OVERDUE,
    SRV_MRE_LAUNCH_APP_EXCEED_FILE_IN_MRE_DIRECTORY,
    SRV_MRE_LAUNCH_APP_SYS_ASYN_ASM,
    SRV_MRE_LAUNCH_APP_BAD_PARAM,
    SRV_MRE_LAUNCH_APP_ONLY_ONE_FOREGROUND,
    SRV_MRE_LAUNCH_APP_MAX_NUM,
    SRV_MRE_LAUNCH_VERSION_NOT_MATCH,
    SRV_MRE_LAUNCH_APP_FORCE,
    SRV_MRE_LAUNCH_APP_END_OF_ENUM
} srv_mre_launch_app_result_enum;

typedef enum
{
    SRV_MRE_APP_STATE_UNKNOWN,
    SRV_MRE_APP_STATE_NONEXIST,
    SRV_MRE_APP_STATE_NONSTART,
    SRV_MRE_APP_STATE_STARTING,
    SRV_MRE_APP_STATE_FORGROUND,
    SRV_MRE_APP_STATE_INACTIVE,
    SRV_MRE_APP_STATE_BACKGROUND,
    SRV_MRE_APP_STATE_CLOSING,
    SRV_MRE_APP_STATE_END_OF_ENUM
} srv_mre_check_app_state_result_enum;

typedef enum
{
    SRV_MRE_INFO_NULL,      /* NULL */
    SRV_MRE_INFO_DEV,       /* developer */
    SRV_MRE_INFO_APP_ID,    /* app id */
    SRV_MRE_INFO_NAME,      /* app name */
    SRV_MRE_INFO_VER,       /* app version id */
    SRV_MRE_INFO_DESC,      /* app introduction */
    SRV_MRE_INFO_TEL,       /* telephone number */
    SRV_MRE_INFO_BG_RUN,    /* wether support bg run */
    SRV_MRE_INFO_END_OF_ENUM
} srv_mre_info_type_enum;

typedef struct
{
    srv_mre_info_type_enum info_id[SRV_MRE_INFO_END_OF_ENUM];
    S32 info_size[SRV_MRE_INFO_END_OF_ENUM];
    S8 *info_data[SRV_MRE_INFO_END_OF_ENUM];
} srv_mre_multi_info_struct;

typedef enum
{
    SRV_MRE_VERITY_INSUFFICIENT_SYS_MEM,
    SRV_MRE_VERIFY_KEY_EXPIRED,         /* fail to invoke the check func */
    SRV_MRE_VERIFY_CHECK_PARAM_FAIL,    /* fail to invoke the check func */
    SRV_MRE_VERIFY_PER_MEM_ERROR,
    SRV_MRE_VERIFY_PER_INIT_ERROR,      /* can not initial permission system */
    SRV_MRE_VERIFY_PER_CATCH_ERROR,     /* compose func list error */
    SRV_MRE_VERIFY_RESOLUTION_DISMATCH, /* the lcd size is smalled than the app requirements */
    SRV_MRE_VERIFY_INSUFFICIENT_MEM,    /* the system can not provide enough memory to run the app */
    SRV_MRE_VERIFY_TIMESTAMP_ERROR,
    SRV_MRE_VERIFY_IMSI_DISMATCH,       /* the app is personal used and the user is not matched */
    SRV_MRE_VERIFY_APP_BANNED,          /* the app is banned */
    SRV_MRE_VERIFY_DIGEST_DISMATCH,     /* the verify result is not matched with the desired one */
    SRV_MRE_VERIFY_VERIFY_FAILED,       /* can not finish the verification with the assigned pub key */
    SRV_MRE_VERIFY_BAD_DIGEST,          /* can not caculate app & cert digest */
    SRV_MRE_VERIFY_BAD_PARAM,           /* can not catch the Cert envelope structure OR can not catch the digest string OR */
    /* any of the points to CertID, AppID, IssueData and ExpiredData is NULL */

    SRV_MRE_VERIFY_OK,  /* verify finished and the app is OK to run */
    SRV_MRE_VERIFY_END_OF_ENUM
} srv_mre_verify_result_enum;

/*****************************************************************************
* FUNCTION
*  srv_mre_is_core_loaded
* DESCRIPTION
*  Check if MRE Core is loaded.
* PARAMETERS
*  void
* RETURN VALUES
*  MMI_TRUE : If loaded.
*  MMI_FALSE : If not loaded.
*****************************************************************************/
extern MMI_BOOL srv_mre_is_core_loaded(void);

/*****************************************************************************
* FUNCTION
*  srv_mre_load_core
* DESCRIPTION
*  Load MRE Core.
* PARAMETERS
*  load_cb : [IN]  Callback function.
*  caller : [IN] Type of load MRE core.
* RETURN VALUES
*  TODO:
*****************************************************************************/
extern srv_mre_load_core_result_enum srv_mre_load_core(
    srv_mre_load_core_cb_t load_cb,
    srv_mre_load_core_caller_enum caller);

/*****************************************************************************
* FUNCTION
*  srv_mre_unload_core
* DESCRIPTION
*  Unload MRE Core.
* PARAMETERS
*  caller : [IN] Type of load MRE core.
* RETURN VALUES
*  void
*****************************************************************************/
extern void srv_mre_unload_core(srv_mre_load_core_caller_enum caller);

/*****************************************************************************
* FUNCTION
*  srv_mre_launch_app
* DESCRIPTION
*  Launch a MRE application.
* PARAMETERS
*  app_path : [IN]  MRE application full path.
*  app_cb : [IN] Callback function.
* RETURN VALUES
*  
*****************************************************************************/
extern srv_mre_launch_app_result_enum srv_mre_launch_app(U16 *app_path, srv_mre_launch_app_cb_t app_cb);

/*****************************************************************************
* FUNCTION
*  srv_mre_close_app
* DESCRIPTION
*  Close a MRE application.
* PARAMETERS
*  app_path : [IN]  MRE application full path.
* RETURN VALUES
*  void
*****************************************************************************/
extern void srv_mre_close_app(U16 *app_path);

/*****************************************************************************
* FUNCTION
*  srv_mre_get_app_state
* DESCRIPTION
*  Get the application's state, including FG RUNNING, BG RUNNING and CLOSE.
* PARAMETERS
*  app_path : [IN]  MRE application full path.
* RETURN VALUES
*  .
*****************************************************************************/
extern srv_mre_check_app_state_result_enum srv_mre_get_app_state(U16 *app_path);

/*****************************************************************************
* FUNCTION
*  srv_mre_get_info_by_tag
* DESCRIPTION
*  Get info by tag.
* PARAMETERS
*  app_path : [IN]  MRE application full path.
*  tag : [IN] Tag type.
*  des_buf : [OUT] Destination buffer.
*  des_size : [OUT] Destination buffer size.
*  lan_type : [IN] Language type.
* RETURN VALUES
*  MMI_TRUE : If successful.
*  MMI_FALSE : If failed.
*****************************************************************************/
extern MMI_BOOL srv_mre_get_info_by_tag(
                                        U16 *app_path,
                                        srv_mre_info_type_enum tag,
                                        void *des_buf,
                                        U32 *des_size,
                                        S32 lan_type);

/*****************************************************************************
* FUNCTION
*  srv_mre_get_app_image
* DESCRIPTION
*  Get the image data of a MRE application. If p_img is NULL, then return the image size by img_size.
* PARAMETERS
*  app_path : [IN]  MRE application full path.
*  p_img : [OUT] Pointer to image buffer.
*  img_size : [OUT] Size of image.
* RETURN VALUES
*  MMI_TRUE : If successful.
*  MMI_FALSE : If failed.
*****************************************************************************/
extern MMI_BOOL srv_mre_get_app_image(U16 *app_path, U8 *p_img, U32 *img_size);

extern MMI_BOOL srv_mre_get_app_image_ex(U16 *app_path, U8 **p_img, U32 *img_size);

extern MMI_BOOL srv_mre_free_app_image_ex(U8 *p_img);

/*****************************************************************************
* FUNCTION
*  srv_mre_get_app_name
* DESCRIPTION
*  Get the name of a MRE application. If p_name is NULL, then return the name size by name_size.
* PARAMETERS
*  app_path : [IN]  MRE application full path.
*  p_name : [OUT] Pointer to name buffer.
*  name_size : [OUT] Size of name.
* RETURN VALUES
*  MMI_TRUE : If successful.
*  MMI_FALSE : If failed.
*****************************************************************************/
extern MMI_BOOL srv_mre_get_app_name(U16 *app_path, U16 *p_name, U32 *name_size);

/*****************************************************************************
* FUNCTION
*  srv_mre_get_app_name
* DESCRIPTION
*  Get the zimo name of a MRE application. If zimo_buf is NULL, then return the name size by name_size.
* PARAMETERS
*  app_path : [IN]  MRE application full path.
*  zimo_buf : [OUT] Pointer to name buffer.
*  name_size : [OUT] Size of name.
*  name_len : [OUT] Length of name.
* RETURN VALUES
*  MMI_TRUE : If successful.
*  MMI_FALSE : If failed.
*****************************************************************************/
extern MMI_BOOL srv_mre_get_app_zimo_name(U16 *app_path, S8 *zimo_buf, U32 *name_size, U32 *name_len);

/*****************************************************************************
* FUNCTION
*  srv_mre_get_app_version
* DESCRIPTION
*  Get the version id of a MRE application. The version id use format x.y.z which present by a U32.
* PARAMETERS
*  app_path : [IN]  MRE application full path.
*  version : [OUT] Version id, first byte is x, second byte is y, third byte is z.
* RETURN VALUES
*  MMI_TRUE : If successful.
*  MMI_FALSE : If failed.
*****************************************************************************/
extern MMI_BOOL srv_mre_get_app_version(U16 *app_path, S32 *version);

/*****************************************************************************
* FUNCTION
*  srv_mre_get_app_id
* DESCRIPTION
*  Get the id of a MRE application. The id uses 32-bits.
* PARAMETERS
*  app_path : [IN]  MRE application full path.
*  p_id : [OUT] Pointer to id buffer.
* RETURN VALUES
*  MMI_TRUE : If successful.
*  MMI_FALSE : If failed.
*****************************************************************************/
extern MMI_BOOL srv_mre_get_app_id(U16 *app_path, U32 *p_id);

/*****************************************************************************
* FUNCTION
*  srv_mre_get_app_developer
* DESCRIPTION
*  Get the developer name of a MRE application. If p_developer is NULL, then return the name size by developer_size.
* PARAMETERS
*  app_path : [IN]  MRE application full path.
*  p_developer : [OUT] Pointer to developer name buffer.
*  developer_size : [OUT] Size of developer name.
* RETURN VALUES
*  MMI_TRUE : If successful.
*  MMI_FALSE : If failed.
*****************************************************************************/
extern MMI_BOOL srv_mre_get_app_developer(U16 *app_path, U16 *p_developer, U32 *developer_size);

/*****************************************************************************
* FUNCTION
*  srv_mre_get_app_description
* DESCRIPTION
*  Get the description of a MRE application. If p_desc is NULL, then return the description size by desc_size.
* PARAMETERS
*  app_path : [IN]  MRE application full path.
*  p_desc : [OUT] Pointer to app description buffer.
*  desc_size : [OUT] Size of app description.
* RETURN VALUES
*  MMI_TRUE : If successful.
*  MMI_FALSE : If failed.
*****************************************************************************/
extern MMI_BOOL srv_mre_get_app_description(U16 *app_path, U16 *p_desc, U32 *desc_size);

/*****************************************************************************
* FUNCTION
*  srv_mre_get_app_tel
* DESCRIPTION
*  Get the telephone number of the developer.
* PARAMETERS
*  app_path : [IN]  MRE application full path.
*  p_tel : [OUT] Pointer to telephone number buffer, and the length of number less than 20.
* RETURN VALUES
*  MMI_TRUE : If successful.
*  MMI_FALSE : If failed.
*****************************************************************************/
extern MMI_BOOL srv_mre_get_app_tel(U16 *app_path, U16 *p_tel);


/*****************************************************************************
* FUNCTION
*  srv_mre_get_app_resolution
* DESCRIPTION
*  Get resolution
* PARAMETERS
*  app_path : [IN]  MRE application full path.
*  width : [OUT] width.
*  height : [OUT] height.
* RETURN VALUES
*  MMI_TRUE : If successful.
*  MMI_FALSE : If failed.
*****************************************************************************/
MMI_BOOL srv_mre_get_app_resolution(U16 *app_path, U16 *width, U16 *height);

/*****************************************************************************
* FUNCTION
*  srv_mre_is_app_bg_running
* DESCRIPTION
*  Check if the application is running in background.
* PARAMETERS
*  app_path : [IN]  MRE application full path.
* RETURN VALUES
*  MMI_TRUE : If support.
*  MMI_FALSE : If not support.
*****************************************************************************/
extern MMI_BOOL srv_mre_is_app_bg_running(U16 *app_path);

/*****************************************************************************
* FUNCTION
*  srv_mre_is_app_support_bg_running
* DESCRIPTION
*  Check if the application support background running.
* PARAMETERS
*  app_path : [IN]  MRE application full path.
* RETURN VALUES
*  MMI_TRUE : If support.
*  MMI_FALSE : If not support.
*****************************************************************************/
extern MMI_BOOL srv_mre_is_app_support_bg_running(U16 *app_path);

/*****************************************************************************
* FUNCTION
*  srv_mre_get_multi_info
* DESCRIPTION
*  Get multiple information from file or rom.
* PARAMETERS
*  app_path : [IN]  MRE application full path.
*  tag : [IN] Tag type.
*  des_buf : [OUT] Destination buffer.
*  des_size : [OUT] Destination buffer size.
* RETURN VALUES
*  MMI_TRUE : If successful.
*  MMI_FALSE : If failed.
*****************************************************************************/
extern MMI_BOOL srv_mre_get_multi_info(U16 *app_path, srv_mre_multi_info_struct *info_req);

/*****************************************************************************
* FUNCTION
*  srv_mre_get_buildin_app_list
* DESCRIPTION
*  Get build-in application full path list. You should get call srv_mre_get_buildin_app_list(NULL, app_num) firstly
*  to get application number, and then prepare enough memory to get the list.
* PARAMETERS
*  app_path_list : [IN]  List of build in application full path.
*  app_num : [OUT]  Number of build in application.
* RETURNS
*  Return number of build in applications
*****************************************************************************/
extern U32 srv_mre_get_buildin_app_list(U16 **app_list, U32 *app_num);
extern U32 srv_mre_get_buildin_3rom_list(U16 **app_path_list, U32 *app_num);

/*****************************************************************************
* FUNCTION
*  srv_mre_is_buildin_app
* DESCRIPTION
*  Check if the app is build-in application.
* PARAMETERS
*  app_path : [IN]  MRE application full path.
* RETURN VALUES
*  MMI_TRUE : If it is a build-in application.
*  MMI_FALSE : If it is not a build-in application.
*****************************************************************************/
extern MMI_BOOL srv_mre_is_buildin_app(U16 *app_path);

/*****************************************************************************
* FUNCTION
*  srv_mre_is_using_media_buffer
* DESCRIPTION
*  Check if MRE using media buffer.
* PARAMETERS
*  void
* RETURN VALUES
*  MMI_TRUE : If using media buffer.
*  MMI_FALSE : If not using media buffer.
*****************************************************************************/
extern MMI_BOOL srv_mre_is_using_media_buffer(void);

/*****************************************************************************
* FUNCTION
*  srv_mre_is_app_valid
* DESCRIPTION
*  Check if the application is valid.
* PARAMETERS
*  app_path : [IN]  MRE application full path.
* RETURN VALUES
*  
*****************************************************************************/
extern U32 srv_mre_is_app_valid(U16 *app_path);

/*****************************************************************************
* FUNCTION
*  srv_mre_is_first_load_core
* DESCRIPTION
*  Check if it is the first time to load MRE Core.
* PARAMETERS
*  void
* RETURN VALUES
*  MMI_TRUE : If it is the first time.
*  MMI_FALSE : If it is not the first time.
*****************************************************************************/
extern MMI_BOOL srv_mre_is_first_load_core(void);

/*****************************************************************************
* FUNCTION
*  srv_mre_get_bg_app_num
* DESCRIPTION
*  get the number of background running app.
* PARAMETERS
*  void
* RETURN VALUES
*  background running app number
*****************************************************************************/
U32 srv_mre_get_bg_app_num(void);


/*****************************************************************************
* FUNCTION
*  srv_mre_get_bg_filename
* DESCRIPTION
*  get the background running file name of specified index
* PARAMETERS
*  index : [IN] the index of background running application to be checked.
*  filename : [OUT] the file name of specified index of background running application.
*  size : [IN] the buffer size of the parameter of filename
* RETURN VALUES
*  MMI_TRUE : get file name successfully
*  MMI_FALSE : there is no background running application of specified index
*****************************************************************************/
MMI_BOOL srv_mre_get_bg_filename(U32 index, U16* filename, U32 size);



/***************************************************************************** 
* application communication service apis
*****************************************************************************/

typedef S32 (*SRV_MRE_MSG_PROC) (S32 sender, U32 msg_id, S32 wparam, S32 lparam);

/*****************************************************************************
* FUNCTION
*  srv_mre_get_running_handle
* DESCRIPTION
*  get process handle of specified file name
* PARAMETERS
*  handle : [IN] file name to be checked. 
* RETURNS
*  the process ID of specified file if larger than zero, 0 means there is no specified file running 
*****************************************************************************/
S32 srv_mre_get_running_handle(WCHAR * file_name);


/*****************************************************************************
* FUNCTION
*  srv_mre_reg_msg_proc
* DESCRIPTION
*  register MRE message proc
* PARAMETERS
*  handle : [IN] message sender handle, if despite of sender, this parameter should be set to zero.
*  proc : [IN] message proc
* RETURNS
*  1 if register successfully
*  0 if register failed
*****************************************************************************/
S32 srv_mre_reg_msg_proc(S32 handle, SRV_MRE_MSG_PROC proc);


/*****************************************************************************
* FUNCTION
*  srv_mre_dereg_msg_proc
* DESCRIPTION
*  deregister MRE message proc
* PARAMETERS
*  handle : [IN] message sender handle, if despite of sender, this parameter should be set to zero.
*  proc : [IN] message proc
* RETURNS
*  1 if deregister successfully
*  0 if deregister failed
*****************************************************************************/
S32 srv_mre_dereg_msg_proc(S32 handle, SRV_MRE_MSG_PROC proc);


/*****************************************************************************
* FUNCTION
*  srv_mre_send_msg
* DESCRIPTION
*  send message to MRE app or native app, will invoke message procedure directly.
* PARAMETERS
*  phandle : [IN] receiver process handle, if receiver is native application, this value should be zero.
*  msg_id : [IN] user defined message ID, should larger than VM_MESSAGE_ID_BASE.
*  wparam : [IN] wparam of message.
*  lparam : [IN] lparam of message.
* RETURNS
*  message procedure return value.
*****************************************************************************/
S32 srv_mre_send_msg(S32 handle, U32 msg_id, S32 wparam, S32 lparam);


/*****************************************************************************
* FUNCTION
*  srv_mre_send_msg
* DESCRIPTION
*  send message to MRE app or native app, will invoke message procedure directly.
* PARAMETERS
*  phandle : [IN] receiver process handle, if receiver is native application, this value should be zero.
*  msg_id : [IN] user defined message ID, should larger than VM_MESSAGE_ID_BASE.
*  wparam : [IN] wparam of message.
*  lparam : [IN] lparam of message.
* RETURNS
*  message procedure return value.
*****************************************************************************/
S32 srv_mre_post_msg(S32 handle, U32 msg_id, S32 wparam, S32 lparam);

/*****************************************************************************
* FUNCTION
*  srv_mre_get_group_id
* DESCRIPTION
*  Get the screen group id of current MRE App
* RETURNS
*  Screen group id of current MRE App
*****************************************************************************/
U32 srv_mre_get_group_id(void);

/*****************************************************************************
* FUNCTION
*  srv_mre_get_res_base
* DESCRIPTION
*  Get the MMI resource base of current MRE App
* RETURNS
*  MMI resource base of current MRE App
*****************************************************************************/
U32 srv_mre_get_res_base(void);

/*****************************************************************************
* FUNCTION
*  srv_mre_set_venus_flag
* DESCRIPTION
*  set Venus flag of MRE app, MRE will trigger key and pen handler even if app is background running
*****************************************************************************/
void srv_mre_set_venus_flag(void);

srv_mre_launch_app_result_enum srv_mre_launch_app_check_cert(U16 *app_path);
MMI_BOOL srv_mre_get_app_type(U16 *app_path, U32 *type);
/*****************************************************************************
* FUNCTION
*  srv_mre_get_ua_string
* DESCRIPTION
*  Get MRE ua string
* RETURNS
*  string length
*****************************************************************************/
U32 srv_mre_get_ua_string(char *buff, U32 size);

/***************************************************************************** 
* Download service apis
*****************************************************************************/
/*
* TODO: Add by Nan
*/

#include "DtcntSrvGprot.h"


#define VM_SRV_DTCNT_PROF_MAX_IP_ADDR_LEN     (64)


typedef struct
{
    U8 APN[SRV_DTCNT_PROF_MAX_APN_LEN+1];    /* account name */
    U8 PrimaryAddr[VM_SRV_DTCNT_PROF_MAX_IP_ADDR_LEN];    /* Primary DNS IP Address (MAX: SRV_DTCNT_PROF_MAX_IP_ADDR_LEN) */
    U8 use_proxy;   /* use proxy flag */
    U8 UserName[SRV_DTCNT_PROF_MAX_USER_LEN+1];         /* User string of a Data Account (ASCII) (MAX: SRV_DTCNT_PROF_MAX_USER_LEN) */
    U8 Passwd[SRV_DTCNT_PROF_MAX_PW_LEN+1];             /* Password for a Data Account (ASCII) (MAX: SRV_DTCNT_PROF_MAX_PW_LEN) */
    U8 px_addr[VM_SRV_DTCNT_PROF_MAX_IP_ADDR_LEN];         /* proxy addr string IP format */
    U16 px_port;                                        /* proxy port */
}vm_srv_dtcnt_info_t;


const vm_srv_dtcnt_info_t * srv_mre_get_cust_dtcnt_info(void);

#endif /* __MRESRVGPROT_H__ */