SHOW Signed
 

net.rim.device.api.system
Class Radio

java.lang.Object
  |
  +--net.rim.device.api.system.Radio

public final class Radio
extends Object

Provides access to the device's radios.

Category:
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.

Since:
JDE 4.2.1
See Also:
RadioInfo

Method Summary
 Category: Signed static boolean activateWAFs(int WAFs)
          This method requests that the radios that belong to the provided Wireless Access Families (WAFs) be powered on.
 Category: Signed static void deactivateWAFs(int WAFs)
          Requests that the radios belonging to the provided Wireless Access Families be powered off.
 
Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Method Detail

activateWAFs

public static boolean activateWAFs(int WAFs)
This method requests that the radios that belong to the provided Wireless Access Families (WAFs) be powered on. A request will not be successful if the BlackBerry device is in the process of an Upgrade over the wireless network, or if the CryptoBlock or USBPasswordRedirectManager does not allow the radio to be turned on.

If the request is successful, and all the specified WAF(s) are supported, the activateWAFs method activates the specified WAF(s). To determine if a WAF is supported, call RadioInfo.areWAFsSupported(int).

Parameters:
WAFs - A bitfield of RadioInfo.WAF_* flags indicating the Wireless Access Families whose radios should be turned on.
Returns:
True if the request was successful and false if not. If the request was successful, it does not guarantee that the specified WAFs were activated.
Throws:
ControlledAccessException - if this operation is not allowed.
Since:
4.2.1
Category:
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.

deactivateWAFs

public static void deactivateWAFs(int WAFs)
Requests that the radios belonging to the provided Wireless Access Families be powered off.
Parameters:
WAFs - A bitfield of RadioInfo.WAF_* flags indicating the Wireless Access Families whose radios should be turned off.
Throws:
ControlledAccessException - if this operation is not allowed.
Since:
JDE 4.2.1
Category:
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.



Copyright 1999-2008 Research In Motion Limited. 295 Phillip Street, Waterloo, Ontario, Canada, N2L 3W8. All Rights Reserved.
Copyright 1993-2003 Sun Microsystems, Inc. 901 San Antonio Road, Palo Alto, California, 94303, U.S.A.
Copyright 2002-2003 Nokia Corporation All Rights Reserved.
Java is a trademark or registered trademark of Sun Microsystems, Inc. in the US and other countries.