Class WiFiAP

Definition

Namespace:

Tizen.Network.WiFi

Assembly:

Tizen.Network.WiFi.dll

API Level:

3

A class for managing the network information of the access point (AP).

public class WiFiAP : IDisposable

Inheritance

Object

WiFiAP

Implements

IDisposable

Constructors

WiFiAP(String)

Creates an object for the access point.

Declaration

public WiFiAP(string essid)

Parameters

Type	Name	Description
String	essid	The Extended Service Set Identifier of the access point.

Exceptions

Type	Condition
NotSupportedException	Thrown when the Wi-Fi is not supported.
UnauthorizedAccessException	Thrown when permission is denied.
ArgumentNullException	Thrown when the ESSID is passed as null.
ArgumentException	Thrown when the method failed due to an invalid parameter.
OutOfMemoryException	Thrown when the system is out of memory.
InvalidOperationException	Thrown when the method failed due to an invalid operation.

API Level: 3

Privilege Level: public

Privilege: http://tizen.org/privilege/network.get

Feature: http://tizen.org/feature/network.wifi

WiFiAP(String, Boolean)

Creates an object for the hidden access point.

Declaration

public WiFiAP(string essid, bool hidden)

Parameters

Type	Name	Description
String	essid	The Extended Service Set Identifier of the access point.
Boolean	hidden	The value to set a hidden AP.

Exceptions

Type	Condition
NotSupportedException	Thrown when the Wi-Fi is not supported.
UnauthorizedAccessException	Thrown when permission is denied.
ArgumentNullException	Thrown when the ESSID is passed as null.
ArgumentException	Thrown when the method failed due to an invalid parameter.
OutOfMemoryException	Thrown when the system is out of memory.
InvalidOperationException	Thrown when the method failed due to an invalid operation.

API Level: 3

Privilege Level: public

Privilege: http://tizen.org/privilege/network.get

Feature: http://tizen.org/feature/network.wifi

Properties

NetworkInformation

The network information of the access point (AP).

Declaration

public WiFiNetwork NetworkInformation { get; }

Property Value

Type	Description
WiFiNetwork	The WiFiNetwork instance containing the network information of the AP.

API Level: 3

SecurityInformation

The security information of the access point (AP).

Declaration

public WiFiSecurity SecurityInformation { get; }

Property Value

Type	Description
WiFiSecurity	The WiFiSecurity instance containing security information of the AP.

API Level: 3

Methods

CancelWps()

Stops ongoing WPS provisioning

Declaration

public static void CancelWps()

Exceptions

Type	Condition
NotSupportedException	Thrown when the Wi-Fi is not supported.
UnauthorizedAccessException	Thrown when permission is denied.
OutOfMemoryException	Thrown when the system is out of memory.
InvalidOperationException	Thrown when the method failed due to an invalid operation.

API Level: 5

Privilege Level: public

Privilege: http://tizen.org/privilege/network.sethttp://tizen.org/privilege/network.get

Feature: http://tizen.org/feature/network.wifi

ConnectAsync()

Connects the access point asynchronously.

Declaration

public Task ConnectAsync()

Returns

Type	Description
Task	A task indicating whether the connect method is done or not.

Remarks

This method must be called from MainThread.

Exceptions

Type	Condition
NotSupportedException	Thrown when the Wi-Fi is not supported.
NowInProgressException	Thrown when the Wi-Fi connection is now in progress.
UnauthorizedAccessException	Thrown when permission is denied.
ObjectDisposedException	Thrown when the object instance is disposed or released.
OutOfMemoryException	Thrown when the system is out of memory.
InvalidOperationException	Thrown when the method failed due to an invalid operation.
InvalidKeyException	Thrown when the key is wrong.

API Level: 3

Privilege Level: public

Privilege: http://tizen.org/privilege/network.sethttp://tizen.org/privilege/network.get

Feature: http://tizen.org/feature/network.wifi

ConnectWpsAsync(WpsInfo)

Connects the access point with the WPS asynchronously.

Declaration

public Task ConnectWpsAsync(WpsInfo info)

Parameters

Type	Name	Description
WpsInfo	info	A WpsInfo instance which is type of WpsPbcInfo or WpsPinInfo.

Returns

Type	Description
Task	A task indicating whether the ConnectWps method is done or not.

Remarks

This method must be called from MainThread.

Exceptions

Type	Condition
NotSupportedException	Thrown when the Wi-Fi is not supported.
UnauthorizedAccessException	Thrown when permission is denied.
ObjectDisposedException	Thrown when the object instance is disposed or released.
ArgumentNullException	Thrown when the WpsPinInfo object is constructed with a null pin.
ArgumentOutOfRangeException	Thrown when the WpsPinInfo object is constructed with a pin which is an empty string or more than 7 characters.
OutOfMemoryException	Thrown when the system is out of memory.
ArgumentException	Thrown when the method failed due to an invalid parameter.
InvalidOperationException	Thrown when the method failed due to an invalid operation.
NowInProgressException	Thrown when the Wi-Fi connection is now in progress.
TimeoutException	Thrown when the timeout of WPS connection is expired.

API Level: 3

Privilege Level: public

Privilege: http://tizen.org/privilege/network.profilehttp://tizen.org/privilege/network.get

Feature: http://tizen.org/feature/network.wifi

ConnectWpsWithoutSsidAsync(WpsInfo)

Connects the access point with WPS without SSID asynchronously.

Declaration

public static Task<WiFiAP> ConnectWpsWithoutSsidAsync(WpsInfo info)

Parameters

Type	Name	Description
WpsInfo	info	A WpsInfo instance which is of type WpsPbcInfo or WpsPinInfo.

Returns

Type	Description
Task<WiFiAP>	A task which contains Connected access point information.

Remarks

If WpsPinInfo is used, its object has to be constructed with a pin which must be 4 or 8 characters long. \n This method must be called from MainThread.

Exceptions

Type	Condition
NotSupportedException	Thrown when the Wi-Fi is not supported.
UnauthorizedAccessException	Thrown when permission is denied.
ArgumentNullException	Thrown when the WpsPinInfo object is constructed with a null pin.
ArgumentOutOfRangeException	Thrown when the WpsPinInfo object is constructed with a pin which is not of 4 or 8 characters long.
OutOfMemoryException	Thrown when the system is out of memory.
ArgumentException	Thrown when the method failed due to an invalid parameter.
InvalidOperationException	Thrown when the method failed due to an invalid operation.
NowInProgressException	Thrown when the Wi-Fi connection is now in progress.
TimeoutException	Thrown when the timeout of WPS connection is expired.

API Level: 3

Privilege Level: public

Privilege: http://tizen.org/privilege/network.sethttp://tizen.org/privilege/network.gethttp://tizen.org/privilege/network.profile

Feature: http://tizen.org/feature/network.wifi

DisconnectAsync()

Disconnects the access point asynchronously.

Declaration

public Task DisconnectAsync()

Returns

Type	Description
Task	A task indicating whether the disconnect method is done or not.

Remarks

This method must be called from MainThread.

Exceptions

Type	Condition
NotSupportedException	Thrown when the Wi-Fi is not supported.
UnauthorizedAccessException	Thrown when permission is denied.
ObjectDisposedException	Thrown when the object instance is disposed or released.
OutOfMemoryException	Thrown when the system is out of memory.
InvalidOperationException	Thrown when the method failed due to an invalid operation.

API Level: 3

Privilege Level: public

Privilege: http://tizen.org/privilege/network.sethttp://tizen.org/privilege/network.get

Feature: http://tizen.org/feature/network.wifi

Dispose()

A method to destroy the managed WiFiAP objects.

Declaration

public void Dispose()

API Level: 3

Finalize()

Destroy the WiFiAP object

Declaration

protected void Finalize()

ForgetAP()

Deletes the information of a stored access point and disconnects it when the AP is connected. If an AP is connected, then the connection information will be stored. This information is used when a connection to that AP is established automatically.

Declaration

public void ForgetAP()

Exceptions

Type	Condition
NotSupportedException	Thrown when the Wi-Fi is not supported.
UnauthorizedAccessException	Thrown when permission is denied.
ObjectDisposedException	Thrown when the object instance is disposed or released.
OutOfMemoryException	Thrown when the system is out of memory.
InvalidOperationException	Thrown when the method failed due to an invalid operation.

API Level: 3

Privilege Level: public

Privilege: http://tizen.org/privilege/network.profilehttp://tizen.org/privilege/network.get

Feature: http://tizen.org/feature/network.wifi

ForgetAPAsync()

Deletes the information of a stored access point and disconnects it when the AP is connected asyncronously. If an AP is connected, then the connection information will be stored. This information is used when a connection to that AP is established automatically.

Declaration

public Task ForgetAPAsync()

Returns

Type	Description
Task	A task indicating whether the disconnect method is done or not.

Remarks

This method must be called from MainThread.

Exceptions

Type	Condition
NotSupportedException	Thrown when the Wi-Fi is not supported.
UnauthorizedAccessException	Thrown when permission is denied.
ObjectDisposedException	Thrown when the object instance is disposed or released.
InvalidOperationException	Thrown when the method failed due to an invalid operation.

API Level: 5

Privilege Level: public

Privilege: http://tizen.org/privilege/network.profilehttp://tizen.org/privilege/network.get

Feature: http://tizen.org/feature/network.wifi

Refresh()

Refreshes the access point information.

Declaration

public void Refresh()

Exceptions

Type	Condition
NotSupportedException	Thrown when the Wi-Fi is not supported.
UnauthorizedAccessException	Thrown when permission is denied.
ObjectDisposedException	Thrown when the object instance is disposed or released.
InvalidOperationException	Thrown when the method failed due to an invalid operation.

API Level: 3

Privilege Level: public

Privilege: http://tizen.org/privilege/network.get

Feature: http://tizen.org/feature/network.wifi

Update()

Update the information of a stored access point. When a AP information is changed, the change will not be applied until this method is called.

Declaration

public void Update()

Exceptions

Type	Condition
NotSupportedException	Thrown when the Wi-Fi is not supported.
UnauthorizedAccessException	Thrown when permission is denied.
ObjectDisposedException	Thrown when the object instance is disposed or released.
OutOfMemoryException	Thrown when the system is out of memory.
InvalidOperationException	Thrown when the method failed due to an invalid operation.

API Level: 5

Privilege Level: public

Privilege: http://tizen.org/privilege/network.profilehttp://tizen.org/privilege/network.get

Feature: http://tizen.org/feature/network.wifi

Implements

System.IDisposable