RIL_GetCurrentRoamingStatus
4/8/2010
Applies to Windows Mobile 6.5.3
For Windows Mobile Professional, additional support is now available for OEMs to set the roaming indicator to flash instead of only solid on or solid off. You turn the flashing roaming indicator on and off through the Radio Interface Layer by adding the roam status flag RIL_ROAMSTATUS_SPECIAL, in addition to the roam flags RIL_ROAMSTATUS_ANALOG or RIL_ROAMSTATUS_DIGITAL.
Syntax
HRESULT RIL_GetCurrentRoamingStatus(
HRIL hRil,
);
Parameters
- RIL_ROAMSTATUS_NONE
0
- RIL_ROAMSTATUS_ANALOG
1
- RIL_ROAMSTATUS_DIGITAL
2
- RIL_ROAMSTATUS_SPECIAL
4
Return Value
If the function succeeds, gets the roaming status of the current system.
Code Example
//
// @doc EXTERNAL
//
// @constants CDMA Roaming Status | CDMA Roaming Status
//
// @comm None
//
// ------------------------------------------------------------------
#define RIL_ROAMSTATUS_NONE 0
#define RIL_ROAMSTATUS_ANALOG 1
#define RIL_ROAMSTATUS_DIGITAL 2
#define RIL_ROAMSTATUS_SPECIAL 4
//
// ------------------------------------------------------------------
//
// @doc EXTERNAL
//
// @func Gets the current roaming status of the current system
//
// @comm Asynchronous. <p lpData> points to a <t DWORD> RIL_ROAMSTATUS_* constant.
//
// ------------------------------------------------------------------
HRESULT RIL_GetCurrentRoamingStatus(
HRIL hRil
// @parm handle to RIL instance returned by <f RIL_Initialize>
);
Description
In the preceding example, to set the roaming indicator to flash on a digital network the returned value would be (RIL_ROAMSTATUS_DIGITAL | RIL_ROAMSTATUS_SPECIAL).