misc.h

/*
 * Copyright (c) 2000-2017 Samsung Electronics Co., Ltd All Rights Reserved
 *
 * PROPRIETARY/CONFIDENTIAL
 *
 * This software is the confidential and proprietary information of
 * SAMSUNG ELECTRONICS ("Confidential Information").
 * You shall not disclose such Confidential Information and shall
 * use it only in accordance with the terms of the license agreement
 * you entered into with SAMSUNG ELECTRONICS.
 * SAMSUNG make no representations or warranties about the suitability
 * of the software, either express or implied, including but not
 * limited to the implied warranties of merchantability, fitness for
 * a particular purpose, or non-infringement.
 * SAMSUNG shall not be liable for any damages suffered by licensee as
 * a result of using, modifying or distributing this software or its derivatives.
 */

#ifndef LIBMDM_MDM_MISC_H
#define LIBMDM_MDM_MISC_H

#ifdef __cplusplus
extern "C" {
#endif

#include <stdbool.h>

#include "mdm_client_type.h"
#include "misc/browser.h"
#include "misc/camera.h"
#include "misc/email.h"
#include "misc/external_storage.h"
#include "misc/microphone.h"
#include "misc/ringtone.h"

typedef enum {
    SIM_CHANGED,    
    SIM_INSERTED,   
    SIM_REMOVED,    
    SIM_NOT_PRESENT 
} sim_change_type_t;

typedef struct {
    char *sim_countryIso;   
    char *sim_operator;     
    char *sim_operatorName; 
    char *sim_phoneNumber;  
    char *sim_serialNumber; 
    char *sim_slot;         
    long  timestamp;        
} sim_info_t;

typedef struct {
    sim_change_type_t change_type;       
    long              change_time;       
    sim_info_t *      current_sim_info;  
    sim_info_t *      previous_sim_info; 
} sim_change_info_t;

/*
 * @brief Type of integrity check status.
 * @since_tizen 2.3.2.3
 * @since_mdm 1.0.0
 */
typedef enum {
    MDM_INTEGRITY_CHECK_STATUS_SUCCESS        = TIZEN_ERROR_NONE,     
    MDM_INTEGRITY_CHECK_STATUS_ADD_ITEM_ERROR = TIZEN_ERROR_NONE - 1, 
    MDM_INTEGRITY_CHECK_STATUS_CHECK_ERROR    = TIZEN_ERROR_NONE - 2, 
    MDM_INTEGRITY_CHECK_STATUS_ADD_ITEM_INVALID_PATH = TIZEN_ERROR_NONE - 3, 
} mdm_misc_integrity_check_error;

/*
 * @brief Type of struct passed as argument to the MISC callbacks.
 * @since_tizen 2.3.2.3
 * @since_mdm 1.0.0
 */
typedef struct {
    bool integrity_check_status;                      /* Status of the integrity process only. In case of integrity
                                                         item add callback the field should be ignore */
    mdm_misc_integrity_check_error error_code;        /* Code of error detected during the verification process. */
    char *                         error_description; /* Description of the error code. */
} mdm_misc_integrity_check_info_cb_t;

/*
 * @brief Integrity checking callback types. The enum should be used when mdm_register_client_callback()
 * MDM SDK API call is used to register on Integrity Check callback.
 * @since_tizen 2.3.2.3
 * @since_mdm 1.0.0
 */
typedef enum {
    MDM_CB_MISC_INTEGRITY_CHECK          = 0, /* Checking integrity callback. */
    MDM_CB_MISC_INTEGRITY_CHECK_ADD_ITEM = 1  /* Add check item callback. */
} mdm_misc_cb;

/*
 * @brief API to start checking integrity process.
 *
 * @since_mdm 1.0.0
 *
 * @since_tizen 2.3.2.3
 *
 * @feature %http://developer.samsung.com/tizen/feature/mdm.misc
 *
 * @par Usage:
 * Admin can use this function to start the integrity verification for items (files/directories)
 * previously added to the checklist using #mdm_integrity_check_add_item. Final integrity status
 * is returned in #MDM_CB_MISC_INTEGRITY_CHECK callback type.
 *
 * @param[in] cb_function callback function
 * @param[in] user_data   user data that will be pass to the callback function
 * @code{.c}

    //
    // Integrity check callback
    //
    static void __integrity_check_callback__(void *cb_data, void *user_data)
    {
        mdm_misc_integrity_check_info_cb_t *cb_info = (mdm_misc_integrity_check_info_cb_t *)cb_data;
        // ...
    }

    int fun()
    {
        // Connect to the MDM
        mdm_get_service();

        mdm_result_t ret = mdm_integrity_check_start(__integrity_check_callback__, NULL);

        if (ret == MDM_RESULT_SUCCESS) {
            // integrity checking started
        } else {
            // error occured
        }
        // ...
    }

 * @endcode
 *
 * @privlevel public
 * @privilege %http://developer.samsung.com/tizen/privilege/mdm.misc
 *
 * @return #mdm_result_t : MDM_RESULT_SUCCESS on success, an error code on error
 *
 * @retval #MDM_RESULT_SUCCESS The integrity checking process started successfully.
 * @retval #MDM_RESULT_FAIL General failure. Refer to #mdm_get_last_error for more details.
 * @retval #MDM_RESULT_NOT_SUPPORTED Not supported.
 * @retval #MDM_RESULT_ACCESS_DENIED The application does not have the privilege to call this function.
 *
 * @par Permission:
 * Usage of this API is restricted to registered clients only.
 *
 * @see mdm_integrity_check_add_item
 *
 */
mdm_result_t mdm_integrity_check_start(mdm_client_callback_function_ext cb_function, void *user_data);

/*
 * @brief API to add an item to integrity checklist.
 *
 * @since_mdm 1.0.0
 *
 * @since_tizen 2.3.2.3
 *
 * @feature %http://developer.samsung.com/tizen/feature/mdm.misc
 *
 * @par Usage:
 * Admin can use this function to add a file/folder to the list of integrity items.
 * If the argument does not stand for a correct destination in the file system #MDM_RESULT_INVALID_PARAM is returned.
 *
 * @param[in] item        File or directory to be added to the checklist.
 * @param[in] cb_function callback function
 * @param[in] user_data   user data that will be pass to the callback function
 *
 * @code{.c}

    //
    // Integrity check callback
    //
    static void __integrity_check_callback__(void *cb_data, void *user_data)
    {
        mdm_misc_integrity_check_info_cb_t *cb_info = (mdm_misc_integrity_check_info_cb_t *)cb_data;
        // ...
    }

    int fun()
    {
        // Connect to the MDM
        mdm_get_service();

        mdm_result_t ret = mdm_integrity_check_add_item("/opt/etc/mdm", __integrity_check_callback__, NULL);

        if (ret == MDM_RESULT_SUCCESS) {
            // integrity checking started
        } else {
            // error occured
        }
    }

 * @endcode
 *
 * @privlevel public
 * @privilege %http://developer.samsung.com/tizen/privilege/mdm.misc
 *
 * @return #mdm_result_t : MDM_RESULT_SUCCESS on success, an error code on error
 *
 * @retval #MDM_RESULT_SUCCESS The item added successfully.
 * @retval #MDM_RESULT_FAIL General failure. Refer to #mdm_get_last_error for more details.
 * @retval #MDM_RESULT_INVALID_PARAM Invalid parameter.
 * @retval #MDM_RESULT_NOT_SUPPORTED Not supported.
 * @retval #MDM_RESULT_ACCESS_DENIED The application does not have the privilege to call this function.
 *
 * @par Permission:
 * Usage of this API is restricted to registered clients only.
 *
 * @see mdm_integrity_check_test_item
 *
 */
mdm_result_t mdm_integrity_check_add_item(const char *item, mdm_client_callback_function_ext cb_function,
                                          void *user_data);

/*
 * @brief API to delete an item from integrity checklist.
 *
 * @since_mdm 1.0.0
 *
 * @since_tizen 2.3.2.3
 *
 * @feature %http://developer.samsung.com/tizen/feature/mdm.misc
 *
 * @par Usage:
 * Admin can use this function to remove a file/folder from the list of integrity items.
 * If the argument does not stand for an existing destination on the checklist #MDM_RESULT_INVALID_PARAM is generated.
 *
 * @param[in] item File or directory to be removed from the checklist.
 *
 * @code{.c}

    mdm_result_t ret = mdm_integrity_check_delete_item("/opt/etc/mdm");

    if (ret == MDM_RESULT_SUCCESS) {
        // item deleted successfully
    } else {
        // error occured
    }

 * @endcode
 *
 * @privlevel public
 * @privilege %http://developer.samsung.com/tizen/privilege/mdm.misc
 *
 * @return #mdm_result_t : MDM_RESULT_SUCCESS on success, an error code on error
 *
 * @retval #MDM_RESULT_SUCCESS The item deleted successfully.
 * @retval #MDM_RESULT_FAIL General failure. Refer to #mdm_get_last_error for more details.
 * @retval #MDM_RESULT_INVALID_PARAM Invalid parameter.
 * @retval #MDM_RESULT_NOT_SUPPORTED Not supported.
 * @retval #MDM_RESULT_ACCESS_DENIED The application does not have the privilege to call this function.
 *
 * @par Permission:
 * Usage of this API is restricted to registered clients only.
 *
 * @see mdm_integrity_check_test_item
 *
 */
mdm_result_t mdm_integrity_check_delete_item(const char *item);

/*
 * @brief API to check if an item figures on integrity checklist.
 *
 * @since_mdm 1.0.0
 *
 * @since_tizen 2.3.2.3
 *
 * @feature %http://developer.samsung.com/tizen/feature/mdm.misc
 *
 * @par Usage:
 * Admin can use this function to verify a file/folder whether it exists on the list of integrity items.
 *
 * @param[in] item File or directory to be checked.
 *
 * @code{.c}

    mdm_status_t stat = mdm_integrity_check_test_item("/opt/etc/mdm");

    if (stat == MDM_TRUE || stat == MDM_FALSE) {
        // function executed successfully
    } else {
        // error occured
    }

 * @endcode
 *
 * @privlevel public
 * @privilege %http://developer.samsung.com/tizen/privilege/mdm.misc
 *
 * @return #mdm_status_t : One of below values:
 * @retval #MDM_TRUE         The item exists on the checklist.
 * @retval #MDM_FALSE        The item does not exist on the checklist.
 * @retval #MDM_STATUS_ERROR General failure.
 *
 * @par Permission:
 * Usage of this API is restricted to registered clients only.
 *
 * @see mdm_integrity_check_add_item
 * @see mdm_integrity_check_delete_item
 *
 */
mdm_status_t mdm_integrity_check_test_item(const char *item);

/*
 * @brief API to get defined by in the system check items from RO list.
 *
 * @since_mdm 1.0.0
 *
 * @since_tizen 2.3.2.3
 *
 * @feature %http://developer.samsung.com/tizen/feature/mdm.misc
 *
 * @par Usage:
 * Admin can use this function get list of integrity check items defined in the system.
 * The API will return check items that belong to RO list only.
 * List of items will be returned as list (GList) of strings.
 *
 * @code{.c}

    mdm_data_t *data = mdm_integrity_check_get_ro_list();

    if(data != NULL) {
        // ...
    } else {
        // ...
    }

 * @endcode
 *
 * @privlevel public
 * @privilege %http://developer.samsung.com/tizen/privilege/mdm.misc
 *
 * @return #mdm_data_t : One of below values:
 * @retval (mdm_data_t *) -> data != NULL - a list of RO items,
 * @retval (mdm_data_t *) -> data == NULL - if RO list is empty
 * @retval (mdm_data_t *) -> ret == #MDM_RESULT_SUCCESS – Success
 * @retval (mdm_data_t *) -> ret == #MDM_RESULT_FAIL – General failure
 * @retval (mdm_data_t *) -> ret == #MDM_RESULT_NOT_SUPPORTED – Not supported
 * @retval (mdm_data_t *) -> ret == #MDM_RESULT_ACCESS_DENIED – The application does not have the privilege to call this
 function.

 * @par Permission:
 * Usage of this API is restricted to registered clients only.
 *
 * @see mdm_integrity_check_add_item, mdm_integrity_check_delete_item, mdm_integrity_check_test_item
 */
mdm_data_t *mdm_integrity_check_get_ro_list(void);

/*
 * @brief API to get defined by in the system check items from RW list.
 *
 * @since_mdm 1.0.0
 *
 * @since_tizen 2.3.2.3
 *
 * @feature %http://developer.samsung.com/tizen/feature/mdm.misc
 *
 * @par Usage:
 * Admin can use this function get list of integrity check items defined in the system.
 * The API will return check items that belong to RW list only.
 * List of items will be returned as list (GList) of strings.
 *
 * @code{.c}

    mdm_data_t *data = mdm_integrity_check_get_rw_list();

    if(data != NULL) {
        // ...
    } else {
        // ...
    }

 * @endcode
 *
 * @privlevel public
 * @privilege %http://developer.samsung.com/tizen/privilege/mdm.misc
 *
 * @return #mdm_data_t : One of below values:
 * @retval (mdm_data_t *) -> data != NULL - a list of RW items,
 * @retval (mdm_data_t *) -> data == NULL - if RW list is empty
 * @retval (mdm_data_t *) -> ret == #MDM_RESULT_SUCCESS – Success
 * @retval (mdm_data_t *) -> ret == #MDM_RESULT_FAIL – General failure
 * @retval (mdm_data_t *) -> ret == #MDM_RESULT_NOT_SUPPORTED – Not supported
 * @retval (mdm_data_t *) -> ret == #MDM_RESULT_ACCESS_DENIED – The application does not have the privilege to call this
 function.

 * @par Permission:
 * Usage of this API is restricted to registered clients only.
 *
 * @see mdm_integrity_check_add_item, mdm_integrity_check_delete_item, mdm_integrity_check_test_item
 */
mdm_data_t *mdm_integrity_check_get_rw_list(void);

mdm_result_t mdm_set_allow_location(mdm_status_t state);

mdm_status_t mdm_get_allow_location(void);

mdm_result_t mdm_set_allow_text_messaging(mdm_status_t state);

mdm_status_t mdm_get_allow_text_messaging(void);

/*
 * @brief API to get the information about the last time the SIM card was changed.
 *
 * @since_mdm 1.0.0
 *
 * @since_tizen 2.3.2.3
 *
 * @feature %http://developer.samsung.com/tizen/feature/mdm
 *
 * @par Usage:
 * Admin can use this API to detect SIM related changes like removal and insertion of SIM card in device and take
 appropriate actions based on enterprise policy.
 *
 * @code{.c}

    mdm_data_t *sim_data = mdm_get_last_sim_change_info();
    if(sim_data)
        SUCCESS
    else
        FAIL
    }
 * @endcode

 *
 * @return #sim_change_info_t list on success, NULL on failure.
 *
 * @retval #MDM_RESULT_SUCCESS Successful
 * @retval #MDM_RESULT_FAIL General failure
 * @retval #MDM_RESULT_NOT_SUPPORTED Not supported
 * @retval #MDM_RESULT_INVALID_PARAM Invalid parameter
 * @retval #MDM_RESULT_ACCESS_DENIED The application does not have the privilege to call this function.
 *
 * @see mdm_msim_get_last_sim_change_info
 */
mdm_data_t *mdm_get_last_sim_change_info(void);

/*
 * @brief API to get the information about the last time the SIM card was changed.
 *
 * @since_mdm 1.1.0
 *
 * @since_tizen 2.3.2.3
 *
 * @feature %http://developer.samsung.com/tizen/feature/mdm
 *
 * @par Usage:
 * Admin can use this API to detect SIM related changes like removal and insertion of SIM card in device and take
 appropriate actions based on enterprise policy.
 *
 * @code{.c}

    mdm_data_t *lp_data = mdm_msim_get_sim_ids();
    if (lp_data && lp_data->sim_ids_list) {
        int i = 0;
        GList *list = lp_data->sim_ids_list;
        GList *l;
        for(l=g_list_first(list); l; l=l->next)
        {
            printf("sim id [%s]\n", (char*)l->data);
            mdm_data_t *sim_data = mdm_msim_get_last_sim_change_info(l->data);
            if(sim_data)
                SUCCESS
            else
                FAIL
        }
        mdm_free_data(lp_data);
    }
 * @endcode

 *
 * @return #sim_change_info_t list on success, NULL on failure.
 *
 * @retval #MDM_RESULT_SUCCESS Successful
 * @retval #MDM_RESULT_FAIL General failure
 * @retval #MDM_RESULT_NOT_SUPPORTED Not supported
 * @retval #MDM_RESULT_INVALID_PARAM Invalid parameter
 * @retval #MDM_RESULT_ACCESS_DENIED The application does not have the privilege to call this function.
 *
 * @see mdm_get_last_sim_change_info
 */
mdm_data_t *mdm_msim_get_last_sim_change_info(const char *slot_id);

/*
 * @brief Specifies whether the device allows the use of SMS or text messaging.
 *
 * @since_mdm 1.1.0
 *
 * @since_tizen 2.3.2.3
 *
 * @feature %http://developer.samsung.com/tizen/feature/mdm
 *
 * @par Usage:
 * Admin can disable the text Messaging capability without any user interaction for specified sim card.
 *
 * @remark
 * Text messaging restriction #mdm_status_t is written to #MDM_POLICY_ON_MESSAGE notification file.
 * You can register a callback for this event using #mdm_register_policy_receiver.
 *
 * @code{.c}

    mdm_result_t ret = MDM_RESULT_SUCCESS;
    ret = mdm_set_allow_text_messaging("SIM1", MDM_RESTRICTED);
    if (ret == MDM_RESULT_SUCCESS) {

    }

 * @endcode
 *
 * @privlevel public
 * @privilege %http://developer.samsung.com/tizen/privilege/mdm.misc
 * @param[in] id    id of sim
 * @param[in] state MDM_RESTRICTED: Disables sending text message, user cannot enable.
 *                  MDM_ALLOWED: user can send text message.
 *
 * @return #mdm_result_t : MDM_RESULT_SUCCESS on success, an error code on error
 *
 * @retval #MDM_RESULT_SUCCESS Successful
 * @retval #MDM_RESULT_FAIL General failure
 * @retval #MDM_RESULT_NOT_SUPPORTED Not supported
 * @retval #MDM_RESULT_INVALID_PARAM Invalid parameter
 * @retval #MDM_RESULT_ACCESS_DENIED The application does not have the privilege to call this function.
 *
 * @par Permission:
 * Usage of this API is restricted to registered clients only.
 *
 * @see mdm_msim_get_allow_text_messaging
 *
 */
mdm_result_t mdm_msim_set_allow_text_messaging(const char *id, mdm_status_t state);

/*
 * @brief Checks whether the Text Messaging capability is enabled or not for specified sim card.
 *
 * @since_mdm 1.1.0
 *
 * @since_tizen 2.3.2.3
 *
 * @feature %http://developer.samsung.com/tizen/feature/mdm
 *
 * @par Usage:
 * Admin can check whether Text Messaging capability is enabled or not, and take appropriate actions based on enterprise
 policy.
 *
 * @code{.c}

    mdm_status_t ret;
    ret = mdm_get_allow_text_messaging("SIM1");
    if (ret == MDM_ALLOWED) {
        // user can send text message.
    }
    else if (ret == MDM_RESTRICTED) {
        // Disabled sending text message
    }

 * @endcode
 *
 * @param[in] id    id of sim
 *
 * @return #mdm_status_t : Whether Text Messaging is enabled for given sim card
 *
 * @retval #MDM_RESTRICTED Restricted
 * @retval #MDM_ALLOWED Allowed.
 *
 * @see mdm_msim_set_allow_text_messaging
 *
 */
mdm_status_t mdm_msim_get_allow_text_messaging(const char *id);

/*
 * More detailed reason for software update failure.
 * @since_tizen 2.3.2.3
 */
typedef enum {
    MDM_FIRMWARE_UPDATE_FAILURE_REASON_NONE,                   
    MDM_FIRMWARE_UPDATE_FAILURE_REASON_UNABLE_TO_COPY,         
    MDM_FIRMWARE_UPDATE_FAILURE_REASON_SIGNATURE_VERIFICATION, 
    MDM_FIRMWARE_UPDATE_FAILURE_REASON_UNABLE_TO_REBOOT,       
    MDM_FIRMWARE_UPDATE_FAILURE_REASON_OTHER                   
} mdm_firmware_update_failure_reason_t;

/*
 * @brief API to trigger a firmware update.
 *
 * @since_mdm 1.0.0
 *
 * @since_tizen 2.3.2.3
 *
 * @feature %http://developer.samsung.com/tizen/feature/mdm
 *
 * @par Usage:
 * Admin client can use this API to perform device firmware update from custom source.
 *
 * @note The source file (described by @p path parameter) won't be deleted.
 * @note Provide absolute @p path to a file.
 *
 * Example scenario:
 * - Admin client checks current version of the firmware and basing on this decides that the firmware has to be updated.
 * - Admin client downloads package with the firmware update and saves it on SD card or internal memory.
 * - Admin client calls mdm_trigger_firmware_update() with path to the update package.
 * - The device will reboot and perform the firmware update.
 *
 * @code{.c}

    static char *_get_new_firmware_url()
    {
        // Checks if new firmware is available.
        // If there is a new firmware it will return pointer to the buffer containing URL to the package.
    }

    static bool _download(const char *url, const char *path)
    {
        // Downloads file and stores it at given path.
    }

    static bool _download_and_update()
    {
        char *url = _get_new_firmware_url();

        if (url == NULL) {
            // Update won't be performed.
            return false;
        }

        const char *path = "/opt/usr/media/Downloads/fota-signed.tar";

        if (! _download(url, path)) {
            // Download failed.
            g_free(url);
            return false;
        }

        mdm_result_t result = mdm_get_service();
        if (result != MDM_RESULT_SUCCESS) {
            // Get service failed, we have no communication with mdm-server.
            g_free(url);
            return false;
        }

        mdm_result_t result = mdm_trigger_firmware_update(path, NULL);
        if (result != MDM_RESULT_SUCCESS) {
            // Update failed.
            g_free(url);
            return false;
        }

        mdm_release_service();

        g_free(url);
        return true;
    }
 * @endcode
 *
 * @privlevel public
 * @privilege %http://developer.samsung.com/tizen/privilege/mdm.misc
 *
 * @param[in]  path            Path to downloaded firmware update package.
 * @param[out] failure_reason  More detailed failure reason. Relevant only if error code is MDM_RESULT_SUCCESS or
 *                             MDM_RESULT_FAIL Might be NULL if user is not interested in result.
 *
 *
 * @return #mdm_result_t : MDM_RESULT_SUCCESS on success, an error code on error
 *
 * @retval #MDM_RESULT_SUCCESS Successful
 * @retval #MDM_RESULT_FAIL General failure
 * @retval #MDM_RESULT_NOT_SUPPORTED Not supported
 * @retval #MDM_RESULT_INVALID_PARAM Invalid parameter
 * @retval #MDM_RESULT_ACCESS_DENIED The application does not have the privilege to call this function.
 *
 */
mdm_result_t mdm_trigger_firmware_update(const char *path, mdm_firmware_update_failure_reason_t *failure_reason);

/* --------------------------------------------------------------------------------------------------------
 *                                        HIDDEN DOCUMENTATION
 * --------------------------------------------------------------------------------------------------------
 *
 * Hidden documentation won't be generated by doxygen unless
 * MISC_HIDDEN_API section is added to the ENABLED_SECTIONS
 * in the Doxygen configuration file.
 */

/*
 * @brief Send ussd request.
 *
 * @since_mdm 1.0.0
 *
 * @since_tizen 2.3.2.3
 *
 * @feature %http://developer.samsung.com/tizen/feature/mdm
 *
 * @par Usage:
 * Admin can send ussd request.
 *
 * @code{.c}

    mdm_data_t ret;
    ret = mdm_msim_send_ussd_request("SIM1", "*#006#");
    if (!ret) {
        // Fail
    }


 * @endcode
 *
 * @return #mdm_data_t : string on success and NULL on failure.
 *
 */
mdm_data_t *mdm_msim_send_ussd_request(const char *slot_id, const char *code);

/*
 * @brief This API make a voice call to specified phone number on voice call preferred sim card.
 *
 * @since_mdm 1.0.0
 *
 * @since_tizen 2.3.2.3
 *
 * @feature %http://developer.samsung.com/tizen/feature/mdm
 *
 * @par Usage:
 * MDM client can make a voice call to specified phone number.
 *
 * @code{.c}
        mdm_result_t ret = mdm_msim_make_voice_call("+48223778901");

    if (ret == MDM_RESULT_SUCCESS) {
        // Request for starting voice call succeeded.
    } else  {
        // voice call failed.
    }

 * @endcode
 *
 * @param[in] id            id of sim
 * @param[in] phone_number  phone number
 *
 * @return #mdm_result_t : MDM_RESULT_SUCCESS on success or error code.
 */
mdm_result_t mdm_msim_make_voice_call(const char *phone_number);

/*
 * @brief This API sends sms to specified phone number.
 *
 * @since_mdm 1.0.0
 *
 * @since_tizen 2.3.2.3
 *
 * @feature %http://developer.samsung.com/tizen/feature/mdm
 *
 * @par Usage:
 * MDM client can send an sms to specified phone number.
 *
 * @code{.c}
        mdm_result_t ret = mdm_msim_send_sms("+48223778901");

    if (ret == MDM_RESULT_SUCCESS) {
        // Request for starting voice call succeeded.
    } else  {
        // voice call failed.
    }

 * @endcode
 *
 * @param[in] id            id of sim
 * @param[in] phone_number  phone number
 *
 * @return #mdm_result_t : MDM_RESULT_SUCCESS on success or error code.
 */
mdm_result_t mdm_msim_send_sms(const char *phone_number, const char *sms_message);

/* -----------------------------------------------------------------------------------------------------------------
 * END OF HIDDEN DOCUMENTATION
 * -----------------------------------------------------------------------------------------------------------------
 */

#ifdef __cplusplus
}
#endif

#endif // LIBMDM_MDM_MISC_H