Roaming policy group

Roaming policy group provides policies for roaming control. More...

Functions
mdm_status_t	mdm_get_allow_roaming_data (void)
	API to check if cellular data usage is allowed while roaming. More...
mdm_result_t	mdm_set_allow_roaming_data (mdm_status_t n_status)
	API to allow or restrict the use of cellular data usage while roaming. More...

Detailed Description

Roaming policy group provides policies for roaming control.

Roaming policy group.

Required Header

#include <mdm.h>

Overview

This group provides APIs to control the various settings related to device roaming.

Function Documentation

mdm_status_t mdm_get_allow_roaming_data

(

void

)

API to check if cellular data usage is allowed while roaming.

Since (Knox_wearable):

1.0.0

Since (Tizen):

2.3.1.5

Feature:

http://developer.samsung.com/tizen/feature/mdm

Usage:

Use API to check if cellular data usage while roaming is allowed, and take appropriate action based on enterprise policy.

mdm_status_t status = MDM_ALLOWED;
status = mdm_get_allow_roaming_data();
if (status != MDM_STATUS_ERROR) {
    if (status == MDM_ALLOWED) {
        //ALLOWED
    } else if (status == MDM_RESTRICTED) {
        //RESTRICTED
    }
} else {
    //ERROR: fail to get the status.
}

Returns

mdm_status_t : The current prevention status.

Return values

MDM_ALLOWED	Cellular data during roaming is allowed.
MDM_RESTRICTED	Cellular data during roaming is restricted.
MDM_STATUS_ERROR	Failure.

See also

mdm_set_allow_roaming_data

mdm_result_t mdm_set_allow_roaming_data

(

mdm_status_t

n_status

)

API to allow or restrict the use of cellular data usage while roaming.

Attention

Deprecated The API call will be replace by mdm_msim_set_allow_roaming_data().

Since (Knox_wearable):

1.0.0

Since (Tizen):

2.3.2.3

Feature:

http://developer.samsung.com/tizen/feature/mdm

Usage:

Use this API to allow or restrict the use of cellular data usage while roaming. This setting is applied only when the device is in roaming mode.
• MDM_RESTRICTED — If set to restricted, the corresponding UI be disabled and will be inaccessible to the end user.
• MDM_ALLOWED — If the status is set to allowed, the corresponding UI for this setting is enabled and the user can change it.

mdm_result_t ret = MDM_RESULT_SUCCESS;
mdm_status_t n_status = MDM_RESTRICTED;

ret = mdm_set_allow_roaming_data(n_status);
if (ret != MDM_RESULT_SUCCESS) {
    //Fail
} else {
    //Success
}

Privilege Level:

public

Privilege:

http://developer.samsung.com/tizen/privilege/mdm.roaming

Parameters

[in]

n_status

MDM_RESTRICTED: Restricts the user from changing this setting and turns off cellular data during roaming. MDM_ALLOWED: Allows the user to change this setting. Cellular data must be turned on manually.

Returns

mdm_result_t : MDM_RESULT_SUCCESS on success, an error code on error

Return values

MDM_RESULT_SUCCESS	Successful
MDM_RESULT_FAIL	General failure
MDM_RESULT_NOT_SUPPORTED	Not supported
MDM_RESULT_INVALID_PARAM	Invalid parameter
MDM_RESULT_ACCESS_DENIED	The application does not have the privilege to call this function.

Permission:

Usage of this API is restricted to registered clients only.

See also

mdm_get_allow_roaming_data