net.rim.device.api.system
Class WLANInfo.WLANAPInfo

java.lang.Object
  extended by net.rim.device.api.system.WLANInfo.WLANAPInfo
Enclosing class:
WLANInfo

public static class WLANInfo.WLANAPInfo
extends Object

Encapsulates information for a Wireless Local Area Network (WLAN) access point.

Since:
BlackBerry API 4.3.0

Field Summary
static int SECURITY_CATEGORY_8021X
          AP has 802.1.x security.
static int SECURITY_CATEGORY_OPEN
          AP has open layer 2 security.
static int SECURITY_CATEGORY_WAPI
          AP has WAPI enterprise security.
static int SECURITY_CATEGORY_WEP
          AP has WEP security.
static int SECURITY_CATEGORY_WPA2_ENTERPRISE
          AP has WPA2 enterprise security.
static int SECURITY_CATEGORY_WPA2_PERSONAL
          AP has WPA2 personal security.
static int SECURITY_CATEGORY_WPA_ENTERPRISE
          AP has WPA enterprise security.
static int SECURITY_CATEGORY_WPA_PERSONAL
          AP has WPA personal security.
 
Method Summary
 int getAPChannel()
          Retrieves the channel of the AP.
 String getBSSID()
          Retrieves the current BSSID.
 int getDataRate()
          Retrieves the current data rate in Mbps.
 String getProfileName()
          Retrieves the current profile name.
 int getRadioBand()
          Retrieves the current radio band.
 String getSSID()
          Retrieves the current SSID.
 int getSecurityCategory()
          Retrieves layer-2 security category of the AP.
 int getSignalLevel()
          Retrieves the current WLAN signal level in dBm.
 
Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 



Field Detail

SECURITY_CATEGORY_OPEN

public static final int SECURITY_CATEGORY_OPEN
AP has open layer 2 security.

See Also:
Constant Field Values
Since:
BlackBerry API 6.0.0

SECURITY_CATEGORY_WEP

public static final int SECURITY_CATEGORY_WEP
AP has WEP security.

See Also:
Constant Field Values
Since:
BlackBerry API 6.0.0

SECURITY_CATEGORY_8021X

public static final int SECURITY_CATEGORY_8021X
AP has 802.1.x security.

See Also:
Constant Field Values
Since:
BlackBerry API 6.0.0

SECURITY_CATEGORY_WPA_PERSONAL

public static final int SECURITY_CATEGORY_WPA_PERSONAL
AP has WPA personal security.

See Also:
Constant Field Values
Since:
BlackBerry API 6.0.0

SECURITY_CATEGORY_WPA_ENTERPRISE

public static final int SECURITY_CATEGORY_WPA_ENTERPRISE
AP has WPA enterprise security.

See Also:
Constant Field Values
Since:
BlackBerry API 6.0.0

SECURITY_CATEGORY_WPA2_PERSONAL

public static final int SECURITY_CATEGORY_WPA2_PERSONAL
AP has WPA2 personal security.

See Also:
Constant Field Values
Since:
BlackBerry API 6.0.0

SECURITY_CATEGORY_WPA2_ENTERPRISE

public static final int SECURITY_CATEGORY_WPA2_ENTERPRISE
AP has WPA2 enterprise security.

See Also:
Constant Field Values
Since:
BlackBerry API 6.0.0

SECURITY_CATEGORY_WAPI

public static final int SECURITY_CATEGORY_WAPI
AP has WAPI enterprise security.

See Also:
Constant Field Values
Since:
BlackBerry API 6.0.0


Method Detail

getProfileName

public String getProfileName()
Retrieves the current profile name.

Returns:
The current profile name.
Throws:
ControlledAccessException - if the calling process does not have the necessary privileges
Since:
BlackBerry API 4.3.0

getSSID

public String getSSID()
Retrieves the current SSID.

Returns:
The current SSID.
Throws:
ControlledAccessException - if the calling process does not have the necessary privileges
Since:
BlackBerry API 4.3.0

getBSSID

public String getBSSID()
Retrieves the current BSSID.

Returns:
The current BSSID.
Throws:
ControlledAccessException - if the calling process does not have the necessary privileges
Since:
BlackBerry API 4.3.0

getRadioBand

public int getRadioBand()
Retrieves the current radio band.

Returns:
One of the WLANInfo.WLAN_BAND_* constants.
Throws:
ControlledAccessException - if the calling process does not have the necessary privileges
Since:
BlackBerry API 4.3.0

getDataRate

public int getDataRate()
Retrieves the current data rate in Mbps.

Returns:
The current data rate in Mbps.
Throws:
ControlledAccessException - if the calling process does not have the necessary privileges
Since:
BlackBerry API 4.3.0

getSignalLevel

public int getSignalLevel()
Retrieves the current WLAN signal level in dBm.

Returns:
The current WLAN signal level in dBm.
Throws:
ControlledAccessException - if the calling process does not have the necessary privileges
Since:
BlackBerry API 4.3.0

getSecurityCategory

public int getSecurityCategory()
Retrieves layer-2 security category of the AP.

Returns:
The security category of the AP (one of the SECURITY_CATEGORY_* constants in this class).
Throws:
ControlledAccessException - if the calling process does not have the necessary privileges
Since:
BlackBerry API 5.0.0

getAPChannel

public int getAPChannel()
Retrieves the channel of the AP.

Returns:
channel of the AP.
Throws:
ControlledAccessException - if the calling process does not have the necessary privileges
Since:
BlackBerry API 5.0.0





Copyright 1999-2010 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. All Rights Reserved.
Copyright 2002-2003 Nokia Corporation All Rights Reserved.
Java is a trademark of Sun Microsystems, Inc.