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

java.lang.Object
  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