net.rim.device.api.system
Class WLANInfo

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

public class WLANInfo
extends Object

Contains Wireless Local Area Network (WLAN) radio information.

Since:
JDE 4.3.0

Inner Class Summary
static class WLANInfo.WLANAPInfo
          Encapsulates information for a Wireless Local Area Network (WLAN) access point.
 
Field Summary
static int WLAN_BAND_A
          Represents the 802.11a radio band.
static int WLAN_BAND_B
          Represents the 802.11b radio band.
static int WLAN_BAND_BG
          Represents the 802.11b/g radio band.
static int WLAN_STATE_CONNECTED
          Represents the WLAN "connected" radio state.
static int WLAN_STATE_DISCONNECTED
          Represents the WLAN "disconnected" radio state.
 
Method Summary
static void addListener(WLANListener listener)
          Adds the provided WLAN listener to the calling application.
static WLANInfo.WLANAPInfo getAPInfo()
          Retrieves a WLANInfo.WLANAPInfo object containing information on the AP the WLAN radio is currently connected to, or null if the WLAN radio is not currently connected to an AP.
static int getWLANState()
          Retrieves the current state of the WLAN radio.
static void removeListener(WLANListener listener)
          Removes the provided WLAN listener from the calling application.
 
Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

WLAN_BAND_A

public static final int WLAN_BAND_A
Represents the 802.11a radio band.
Since:
JDE 4.3.0

WLAN_BAND_B

public static final int WLAN_BAND_B
Represents the 802.11b radio band.
Since:
JDE 4.3.0

WLAN_BAND_BG

public static final int WLAN_BAND_BG
Represents the 802.11b/g radio band.
Since:
JDE 4.3.0

WLAN_STATE_CONNECTED

public static final int WLAN_STATE_CONNECTED
Represents the WLAN "connected" radio state.
Since:
JDE 4.3.0

WLAN_STATE_DISCONNECTED

public static final int WLAN_STATE_DISCONNECTED
Represents the WLAN "disconnected" radio state.
Since:
JDE 4.3.0
Method Detail

addListener

public static void addListener(WLANListener listener)
Adds the provided WLAN listener to the calling application. Currently, only WLANConnectionListeners are supported.
Parameters:
listener - The WLAN listener to add to the calling application.
Throws:
NullPointerException - if listener is null.
Since:
JDE 4.3.0

getAPInfo

public static WLANInfo.WLANAPInfo getAPInfo()
Retrieves a WLANInfo.WLANAPInfo object containing information on the AP the WLAN radio is currently connected to, or null if the WLAN radio is not currently connected to an AP.
Returns:
A WLANInfo.WLANAPInfo object, or null if the WLAN radio is not currently connected to an AP.
Since:
JDE 4.3.0

getWLANState

public static int getWLANState()
Retrieves the current state of the WLAN radio.
Returns:
One of the WLAN_STATE_* constants.
Since:
JDE 4.3.0

removeListener

public static void removeListener(WLANListener listener)
Removes the provided WLAN listener from the calling application. Currently, only WLANConnectionListeners are supported.
Parameters:
listener - The WLAN listener to remove from the calling application.
Since:
JDE 4.3.0



Copyright 1999-2009 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.