Tizen Native API  4.0

The TDLS APIs for managing TDLS.

Required Header

#include <wifi.h>

Overview

The TDLS APIs for managing TDLS.

Required Header

This API is related with the following features:

  • http://tizen.org/feature/network.wifi.tdls
    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 featuring your application can be found from Feature List.

Functions

int wifi_tdls_disconnect (const char *peer_mac_addr) TIZEN_DEPRECATED_API
 Disconnects the connected peer.
int wifi_tdls_get_connected_peer (char **peer_mac_addr) TIZEN_DEPRECATED_API
 Gets Peer Mac address of Connected peer.
int wifi_tdls_set_state_changed_cb (wifi_tdls_state_changed_cb callback, void *user_data) TIZEN_DEPRECATED_API
 Registers the callback called when TDLS state is changed.
int wifi_tdls_unset_state_changed_cb (void) TIZEN_DEPRECATED_API
 Unregisters the callback called when TDLS state is changed.

Typedefs

typedef void(* wifi_tdls_state_changed_cb )(wifi_tdls_state_e state, char *peer_mac_addr, void *user_data)
 Called when the WiFi TDLS state is changed.

Typedef Documentation

typedef void(* wifi_tdls_state_changed_cb)(wifi_tdls_state_e state, char *peer_mac_addr, void *user_data)

Called when the WiFi TDLS state is changed.

Deprecated:
Deprecated since 3.0. Use wifi_manager_tdls_state_changed_cb instead.
Since :
3.0
Parameters:
[in]stateThe TDLS state
[in]peer_mac_addrMAC address of the TDLS peer
[in]user_dataThe user data passed from the callback registration function
See also:
wifi_tdls_set_state_changed_cb()
wifi_tdls_unset_state_changed_cb()

Enumeration Type Documentation

Enumeration for the state of the Wi-Fi TDLS.

Deprecated:
Deprecated since 3.0. Use wifi_manager_tdls_state_e instead.
Since :
3.0
Enumerator:
WIFI_TDLS_STATE_DISCONNECTED 

Wi-Fi TDLS is Disconnected

WIFI_TDLS_STATE_CONNECTED 

Wi-Fi TDLS is Connected


Function Documentation

int wifi_tdls_disconnect ( const char *  peer_mac_addr)

Disconnects the connected peer.

Deprecated:
Deprecated since 3.0. Use wifi_manager_tdls_disconnect() instead.
Since :
3.0
Privilege Level:
public
Privilege:
http://tizen.org/privilege/network.set
Parameters:
[in]peer_mac_addrThe MAC address of the connected peer
Returns:
0 on success, otherwise negative error value
Return values:
WIFI_ERROR_NONESuccessful
WIFI_ERROR_INVALID_OPERATIONInvalid operation
WIFI_ERROR_INVALID_PARAMETERInvalid parameter
WIFI_ERROR_OPERATION_FAILEDOperation failed
WIFI_ERROR_PERMISSION_DENIEDPermission Denied
WIFI_ERROR_NOT_SUPPORTEDNot supported
int wifi_tdls_get_connected_peer ( char **  peer_mac_addr)

Gets Peer Mac address of Connected peer.

Deprecated:
Deprecated since 3.0. Use wifi_manager_tdls_get_connected_peer() instead.
Since :
3.0
Privilege Level:
public
Privilege:
http://tizen.org/privilege/network.get
Remarks:
The peer_mac_addr should be freed using free().
Parameters:
[out]peer_mac_addrThe MAC address of the connected peer
Returns:
0 on success, otherwise negative error value
Return values:
WIFI_ERROR_NONESuccessful
WIFI_ERROR_INVALID_OPERATIONInvalid operation
WIFI_ERROR_INVALID_PARAMETERInvalid parameter
WIFI_ERROR_OPERATION_FAILEDOperation failed
WIFI_ERROR_NO_CONNECTIONNo active TDLS Connection
WIFI_ERROR_PERMISSION_DENIEDPermission Denied
WIFI_ERROR_NOT_SUPPORTEDNot supported
int wifi_tdls_set_state_changed_cb ( wifi_tdls_state_changed_cb  callback,
void *  user_data 
)

Registers the callback called when TDLS state is changed.

Deprecated:
Deprecated since 3.0. Use wifi_manager_tdls_set_state_changed_cb() instead.
Since :
3.0
Parameters:
[in]callbackThe callback function to be called
[in]user_dataThe user data passed to the callback function
Returns:
0 on success, otherwise negative error value
Return values:
WIFI_ERROR_NONESuccessful
WIFI_ERROR_INVALID_OPERATIONInvalid operation
WIFI_ERROR_INVALID_PARAMETERInvalid parameter
WIFI_ERROR_NOT_SUPPORTEDNot supported

Unregisters the callback called when TDLS state is changed.

Deprecated:
Deprecated since 3.0. Use wifi_manager_tdls_unset_state_changed_cb() instead.
Since :
3.0
Returns:
0 on success, otherwise negative error value
Return values:
WIFI_ERROR_NONESuccessful
WIFI_ERROR_INVALID_OPERATIONInvalid operation
WIFI_ERROR_NOT_SUPPORTEDNot supported