Tizen Native API  4.0
AP

The Access Point API provides functions for managing the Access Point.

Required Header

#include <wifi.h>

Overview

The Access Point API provides functions for managing the Access Point. You need to create the ap handle for using the functions. You can use Wi-Fi information with the handle.

Related Features

This API is related with the following features:

Functions

int wifi_ap_create (const char *essid, wifi_ap_h *ap) TIZEN_DEPRECATED_API
 Creates the access point handle.
int wifi_ap_hidden_create (const char *essid, wifi_ap_h *ap) TIZEN_DEPRECATED_API
 Creates the hidden access point handle.
int wifi_ap_destroy (wifi_ap_h ap) TIZEN_DEPRECATED_API
 Destroys the access point handle.
int wifi_ap_clone (wifi_ap_h *cloned_ap, wifi_ap_h origin) TIZEN_DEPRECATED_API
 Clones the access point handle.
int wifi_ap_refresh (wifi_ap_h ap) TIZEN_DEPRECATED_API
 Refreshes the access point information.

Typedefs

typedef void * wifi_ap_h
 The Wi-Fi access point handle.

Typedef Documentation

typedef void* wifi_ap_h

The Wi-Fi access point handle.

Deprecated:
Deprecated since 3.0. Use wifi_manager_ap_h instead.
Since :
2.3

Function Documentation

int wifi_ap_clone ( wifi_ap_h cloned_ap,
wifi_ap_h  origin 
)

Clones the access point handle.

Deprecated:
Deprecated since 3.0. Use wifi_manager_ap_clone() instead.
Since :
2.3
Remarks:
You must release cloned_ap using wifi_ap_destroy().
Parameters:
[out]cloned_apThe cloned access point handle
[in]originThe origin access point handle
Returns:
0 on success, otherwise negative error value
Return values:
WIFI_ERROR_NONESuccessful
WIFI_ERROR_INVALID_PARAMETERInvalid parameter
WIFI_ERROR_OUT_OF_MEMORYOut of memory
WIFI_ERROR_NOT_SUPPORTEDNot supported
See also:
wifi_ap_destroy()
int wifi_ap_create ( const char *  essid,
wifi_ap_h ap 
)

Creates the access point handle.

Deprecated:
Deprecated since 3.0. Use wifi_manager_ap_create() instead.
Since :
2.3
Remarks:
You must release ap using wifi_ap_destroy().
Parameters:
[in]essidThe ESSID (Extended Service Set Identifier) should be null-terminated and can be UTF-8 encoded
[out]apThe access point handle
Returns:
0 on success, otherwise negative error value
Return values:
WIFI_ERROR_NONESuccessful
WIFI_ERROR_INVALID_PARAMETERInvalid parameter
WIFI_ERROR_OUT_OF_MEMORYOut of memory
WIFI_ERROR_PERMISSION_DENIEDPermission Denied
WIFI_ERROR_NOT_SUPPORTEDNot supported
See also:
wifi_ap_destroy()

Destroys the access point handle.

Deprecated:
Deprecated since 3.0. Use wifi_manager_ap_destroy() instead.
Since :
2.3
Parameters:
[in]apThe access point handle
Returns:
0 on success, otherwise negative error value
Return values:
WIFI_ERROR_NONESuccessful
WIFI_ERROR_INVALID_PARAMETERInvalid parameter
WIFI_ERROR_NOT_SUPPORTEDNot supported
See also:
wifi_ap_create()
int wifi_ap_hidden_create ( const char *  essid,
wifi_ap_h ap 
)

Creates the hidden access point handle.

Deprecated:
Deprecated since 3.0. Use wifi_manager_ap_hidden_create() instead.
Since :
2.3
Remarks:
You must release ap using wifi_ap_destroy().
Parameters:
[in]essidThe ESSID (Extended Service Set Identifier) should be null-terminated and can be UTF-8 encoded
[out]apThe access point handle
Returns:
0 on success, otherwise negative error value
Return values:
WIFI_ERROR_NONESuccessful
WIFI_ERROR_INVALID_PARAMETERInvalid parameter
WIFI_ERROR_OUT_OF_MEMORYOut of memory
WIFI_ERROR_NOT_SUPPORTEDNot supported
See also:
wifi_ap_destroy()

Refreshes the access point information.

Deprecated:
Deprecated since 3.0. Use wifi_manager_ap_refresh() instead.
Since :
2.3
Privilege Level:
public
Privilege:
http://tizen.org/privilege/network.get
Remarks:
You should call this function in order to get the current access point information, because the information can be changed.
Parameters:
[in]apThe access point handle
Returns:
0 on success, otherwise negative error value
Return values:
WIFI_ERROR_NONESuccessful
WIFI_ERROR_INVALID_PARAMETERInvalid parameter
WIFI_ERROR_OPERATION_FAILEDOperation failed
WIFI_ERROR_OUT_OF_MEMORYOut of memory
WIFI_ERROR_PERMISSION_DENIEDPermission Denied
WIFI_ERROR_NOT_SUPPORTEDNot supported