The Security Information API provides functions for managing the Security information.

Required Header

#include <wifi.h>

Overview

The Security Information API provides functions for managing the Security information. You can manage the Security information using the functions.

Related Features

This API is related with the following features:

http://tizen.org/feature/network.wifi
It is recommended to design applications with regard to features, for reliability.
You can check if a device supports the related features for this API by using System Information, and control your application's actions accordingly.
To ensure your application is only running on the device with specific features, please define the features in your manifest file using the manifest editor in the SDK.
More details on using features in your application can be found in the Feature List.

Functions
int	wifi_ap_get_security_type (wifi_ap_h ap, wifi_security_type_e *type) TIZEN_DEPRECATED_API
	Gets the Wi-Fi security mode.
int	wifi_ap_set_security_type (wifi_ap_h ap, wifi_security_type_e type) TIZEN_DEPRECATED_API
	Sets the Wi-Fi security mode.
int	wifi_ap_get_encryption_type (wifi_ap_h ap, wifi_encryption_type_e *type) TIZEN_DEPRECATED_API
	Gets the Wi-Fi encryption type.
int	wifi_ap_set_encryption_type (wifi_ap_h ap, wifi_encryption_type_e type) TIZEN_DEPRECATED_API
	Sets the Wi-Fi encryption type.
int	wifi_ap_is_passphrase_required (wifi_ap_h ap, bool *required) TIZEN_DEPRECATED_API
	Checks whether the passphrase is required or not.
int	wifi_ap_set_passphrase (wifi_ap_h ap, const char *passphrase) TIZEN_DEPRECATED_API
	Sets the passphrase.
int	wifi_ap_is_wps_supported (wifi_ap_h ap, bool *supported) TIZEN_DEPRECATED_API
	Checks whether the WPS(Wi-Fi Protected Setup) is supported or not.

Enumeration Type Documentation

enum wifi_encryption_type_e

Enumeration for Wi-Fi encryption type.

Deprecated:: Deprecated since 3.0. Use wifi_manager_encryption_type_e instead.

The following encryption modes are used in infrastructure and ad-hoc mode.

Since :: 2.3.1

Enumerator:

WIFI_ENCRYPTION_TYPE_NONE	Encryption disabled
WIFI_ENCRYPTION_TYPE_WEP	WEP
WIFI_ENCRYPTION_TYPE_TKIP	TKIP
WIFI_ENCRYPTION_TYPE_AES	AES
WIFI_ENCRYPTION_TYPE_TKIP_AES_MIXED	TKIP and AES are both supported

enum wifi_security_type_e

Enumeration for Wi-Fi security type.

Deprecated:: Deprecated since 3.0. Use wifi_manager_security_type_e instead.

The following security modes are used in infrastructure and ad-hoc mode. For now all EAP security mechanisms are provided only in infrastructure mode.

Since :: 2.3.1

Enumerator:

WIFI_SECURITY_TYPE_NONE	Security disabled
WIFI_SECURITY_TYPE_WEP	WEP
WIFI_SECURITY_TYPE_WPA_PSK	WPA-PSK
WIFI_SECURITY_TYPE_WPA2_PSK	WPA2-PSK
WIFI_SECURITY_TYPE_EAP	EAP

Function Documentation

int wifi_ap_get_encryption_type	(	wifi_ap_h	ap,
		wifi_encryption_type_e *	type
	)

Gets the Wi-Fi encryption type.

Deprecated:: Deprecated since 3.0. Use wifi_manager_ap_get_encryption_type() instead.

Since :: 2.3.1

Parameters:

[in]	ap	The access point handle
[out]	type	The type of Wi-Fi encryption

Returns:: 0 on success, otherwise negative error value

Return values:

WIFI_ERROR_NONE	Successful
WIFI_ERROR_INVALID_PARAMETER	Invalid parameter
WIFI_ERROR_OPERATION_FAILED	Operation failed
WIFI_ERROR_NOT_SUPPORTED	Not supported

int wifi_ap_get_security_type	(	wifi_ap_h	ap,
		wifi_security_type_e *	type
	)

Gets the Wi-Fi security mode.

Deprecated:: Deprecated since 3.0. Use wifi_manager_ap_get_security_type() instead.

Since :: 2.3.1

Parameters:

[in]	ap	The access point handle
[out]	type	The type of Wi-Fi security

Returns:: 0 on success, otherwise negative error value

Return values:

WIFI_ERROR_NONE	Successful
WIFI_ERROR_INVALID_PARAMETER	Invalid parameter
WIFI_ERROR_OPERATION_FAILED	Operation failed
WIFI_ERROR_NOT_SUPPORTED	Not supported

int wifi_ap_is_passphrase_required	(	wifi_ap_h	ap,
		bool *	required
	)

Checks whether the passphrase is required or not.

Deprecated:: Deprecated since 3.0. Use wifi_manager_ap_is_passphrase_required() instead.

Since :: 2.3.1

Remarks:: This function is not valid if security type is WIFI_SECURITY_TYPE_EAP.

Parameters:

[in]	ap	The access point handle
[out]	required	`true` if passphrase is required, `false` if passphrase is not required.

Returns:: 0 on success, otherwise negative error value

Return values:

WIFI_ERROR_NONE	Successful
WIFI_ERROR_INVALID_PARAMETER	Invalid parameter
WIFI_ERROR_OPERATION_FAILED	Operation failed
WIFI_ERROR_NOT_SUPPORTED	Not supported

int wifi_ap_is_wps_supported	(	wifi_ap_h	ap,
		bool *	supported
	)

Checks whether the WPS(Wi-Fi Protected Setup) is supported or not.

Deprecated:: Deprecated since 3.0. Use wifi_manager_ap_is_wps_supported() instead.

Since :: 2.3.1

Parameters:

[in]	ap	The access point handle
[out]	supported	`ture` if WPS is supported, otherwise `false` is WPS is not supported.

Returns:: 0 on success, otherwise negative error value

Return values:

WIFI_ERROR_NONE	Successful
WIFI_ERROR_INVALID_PARAMETER	Invalid parameter
WIFI_ERROR_OPERATION_FAILED	Operation failed
WIFI_ERROR_NOT_SUPPORTED	Not supported

See also:: wifi_connect_by_wps_pbc(); wifi_connect_by_wps_pin()

int wifi_ap_set_encryption_type	(	wifi_ap_h	ap,
		wifi_encryption_type_e	type
	)

Sets the Wi-Fi encryption type.

Deprecated:: Deprecated since 3.0. Use wifi_manager_ap_set_encryption_type() instead.

Since :: 2.3.1

Parameters:

[in]	ap	The access point handle
[in]	type	The type of Wi-Fi encryption

Returns:: 0 on success, otherwise negative error value

Return values:

WIFI_ERROR_NONE	Successful
WIFI_ERROR_INVALID_PARAMETER	Invalid parameter
WIFI_ERROR_OPERATION_FAILED	Operation failed
WIFI_ERROR_NOT_SUPPORTED	Not supported

int wifi_ap_set_passphrase	(	wifi_ap_h	ap,
		const char *	passphrase
	)

Sets the passphrase.

Deprecated:: Deprecated since 3.0. Use wifi_manager_ap_set_passphrase() instead.

Since :: 2.3.1

Parameters:

[in]	ap	The access point handle
[in]	passphrase	The passphrase of access point

Returns:: 0 on success, otherwise negative error value

Return values:

WIFI_ERROR_NONE	Successful
WIFI_ERROR_INVALID_PARAMETER	Invalid parameter
WIFI_ERROR_OPERATION_FAILED	Operation failed
WIFI_ERROR_NOT_SUPPORTED	Not supported

int wifi_ap_set_security_type	(	wifi_ap_h	ap,
		wifi_security_type_e	type
	)

Sets the Wi-Fi security mode.

Deprecated:: Deprecated since 3.0. Use wifi_manager_ap_set_security_type() instead.

Since :: 2.3.1

Parameters:

[in]	ap	The access point handle
[in]	type	The type of Wi-Fi security

Returns:: 0 on success, otherwise negative error value

Return values:

WIFI_ERROR_NONE	Successful
WIFI_ERROR_INVALID_PARAMETER	Invalid parameter
WIFI_ERROR_OPERATION_FAILED	Operation failed
WIFI_ERROR_NOT_SUPPORTED	Not supported

Required Header

Overview

Related Features

Functions

Enumeration Type Documentation

Function Documentation