Knox Tizen Wearable SDK
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.
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_ALLOWEDCellular data during roaming is allowed.
MDM_RESTRICTEDCellular data during roaming is restricted.
MDM_STATUS_ERRORFailure.
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.
if (ret != MDM_RESULT_SUCCESS) {
//Fail
} else {
//Success
}
Privilege Level:
public
Privilege:
http://developer.samsung.com/tizen/privilege/mdm.roaming
Parameters
[in]n_statusMDM_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_SUCCESSSuccessful
MDM_RESULT_FAILGeneral failure
MDM_RESULT_NOT_SUPPORTEDNot supported
MDM_RESULT_INVALID_PARAMInvalid parameter
MDM_RESULT_ACCESS_DENIEDThe 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