Called when the connection is accepted or rejected.

Since :

6.5

Parameters:

[in]	service_name	The name of service The service_name can be used only in the callback. To use outside, make a copy.
[in]	peer_info	The Cion peer information handle The peer_info can be used only in the callback. To use outside, make a copy.
[in]	result	The handle for connection result The result can be used only in the callback. To use outside, make a copy.
[in]	user_data	The user data

See also:

cion_client_add_connection_result_cb()

cion_peer_info_h

cion_connection_result_h

Called when the connection is disconnected.

Since :

6.5

Parameters:

[in]	service_name	The name of service The service_name can be used only in the callback. To use outside, make a copy.
[in]	peer_info	The cion peer information handle The peer_info can be used only in the callback. To use outside, make a copy.
[in]	user_data	The user data

See also:

cion_client_add_disconnected_cb()

cion_peer_info_h

The Cion client handle.

Since :

6.5

Called after sending payload asynchronously.

Since :

6.5

Parameters:

[in]	result	The result of sending payload The result can be used only in the callback. To use outside, make a copy.
[in]	user_data	The user data

See also:

cion_client_send_payload_async()

cion_payload_async_result_h

Called when the payload is received.

Since :

6.5

Parameters:

[in]	service_name	The name of service The service_name is the name of connected service that sent the payload. The service_name can be used only in the callback. To use outside, make a copy.
[in]	peer_info	The Cion peer information handle The peer_info can be used only in the callback. To use outside, make a copy.
[in]	payload	The received payload The payload can be used only in the callback. The payload should not be released.
[in]	status	The status of transfer
[in]	user_data	The user data

See also:

cion_client_add_payload_received_cb()

cion_peer_info_h

cion_payload_h

cion_payload_transfer_status_e

Called when the server is discovered.

Since :

6.5

Parameters:

[in]	service_name	The name of service The service_name can be used only in the callback. To use outside, make a copy.
[in]	peer_info	The Cion peer information handle The peer_info can be used only in the callback. To use outside, make a copy.
[in]	user_data	The user data

See also:

cion_client_try_discovery()

cion_peer_info_h

Adds callback function for connection result.

Since :

6.5

Parameters:

[in]	client	The Cion client handle
[in]	cb	The callback function
[in]	user_data	The user data

Returns:

0 on success, otherwise a negative error value

Return values:

CION_ERROR_NONE	Successful
CION_ERROR_INVALID_PARAMETER	Invalid parameter

See also:

cion_client_connection_result_cb()

cion_client_remove_connection_result_cb()

Sample code:

#include <cion.h>

{
    int ret;

    ret = cion_client_add_connection_result_cb(client,
            _cion_client_connection_result_cb, NULL);
}

Adds callback function for disconnection event.

Since :

6.5

Parameters:

[in]	client	The Cion client handle
[in]	cb	The callback function
[in]	user_data	The user data

Returns:

0 on success, otherwise a negative error value

Return values:

CION_ERROR_NONE	Successful
CION_ERROR_INVALID_PARAMETER	Invalid parameter

See also:

cion_client_disconnected_cb()

cion_client_remove_disconnected_cb()

Sample code:

#include <cion.h>

{
    int ret;

    ret = cion_client_add_disconnected_cb(client,
            _cion_client_disconnected_cb, NULL);
}

Adds callback function to receive payload.

Since :

6.5

Parameters:

[in]	client	The Cion client handle
[in]	cb	The callback function
[in]	user_data	The user data

Returns:

0 on success, otherwise a negative error value

Return values:

CION_ERROR_NONE	Successful
CION_ERROR_INVALID_PARAMETER	Invalid parameter

See also:

cion_client_payload_received_cb()

cion_client_remove_payload_received_cb()

Sample code:

#include <cion.h>

{
    int ret;

    ret = cion_client_add_payload_received_cb(client,
            _cion_client_payload_received_cb, NULL);
}

Tries to connect to the Cion server.

Since :

6.5

Privilege Level:

public

Privilege:

http://tizen.org/privilege/d2d.datasharing
http://tizen.org/privilege/internet

Parameters:

[in]	client	The Cion client handle
[in]	peer_info	The Cion peer information handle

Returns:

0 on success, otherwise a negative error value

Return values:

CION_ERROR_NONE	Successful
CION_ERROR_PERMISSION_DENIED	Permission denied
CION_ERROR_INVALID_PARAMETER	Invalid parameter
CION_ERROR_INVALID_OPERATION	Invalid operation
CION_ERROR_IO_ERROR	IO error

Sample code:

#include <cion.h>

{
    int ret;

    ret = cion_client_connect(client, peer_info);
}

Creates a Cion client handle.

The Cion client requests connection to server.

Since :

6.5

Remarks:

client must be released using cion_client_destroy().

Max length of service_name including the null terminator is 512.

Parameters:

[out]	client	The Cion client handle
[in]	service_name	The name of service
[in]	security	The Cion security handle

Returns:

0 on success, otherwise a negative error value

Return values:

CION_ERROR_NONE	Successful
CION_ERROR_NOT_SUPPORTED	Not supported
CION_ERROR_INVALID_PARAMETER	Invalid parameter
CION_ERROR_OUT_OF_MEMORY	Out of memory
CION_ERROR_INVALID_OPERATION	Invalid operation
CION_ERROR_OPERATION_FAILED	Operation failed

See also:

cion_server_destroy()

cion_security_create()

Sample code:

#include <cion.h>

{
    int ret;
    cion_client_h client = NULL;

    ret = cion_client_create(&client, "myclient", NULL);
}

Destroys the Cion client handle.

Since :

6.5

Parameters:

[in]

client

The Cion client handle

Returns:

0 on success, otherwise a negative error value

Return values:

CION_ERROR_NONE	Successful
CION_ERROR_INVALID_PARAMETER	Invalid parameter

See also:

cion_security_create()

Sample code:

#include <cion.h>

{
    int ret;

    ret = cion_client_destroy(client);
}

Disconnects from a server.

Since :

6.5

Parameters:

[in]

client

The Cion client handle

Returns:

0 on success, otherwise a negative error value

Return values:

CION_ERROR_NONE	Successful
CION_ERROR_INVALID_PARAMETER	Invalid parameter

Sample code:

#include <cion.h>

{
    int ret;

    ret = cion_client_disconnect(client);
}

Removes callback function for connection result.

Since :

6.5

Parameters:

[in]	client	The Cion client handle
[in]	cb	The callback function

Returns:

0 on success, otherwise a negative error value

Return values:

CION_ERROR_NONE	Successful
CION_ERROR_INVALID_PARAMETER	Invalid parameter

See also:

cion_client_connection_result_cb()

cion_client_add_connection_result_cb()

Sample code:

#include <cion.h>

{
    int ret;

    ret = cion_client_remove_connection_result_cb(client,
            _cion_client_connection_result_cb);
}

Removes callback function for disconnection event.

Since :

6.5

Parameters:

[in]	client	The Cion client handle
[in]	cb	The callback function

Returns:

0 on success, otherwise a negative error value

Return values:

CION_ERROR_NONE	Successful
CION_ERROR_INVALID_PARAMETER	Invalid parameter

See also:

cion_client_disconnected_cb()

cion_client_add_disconnected_cb()

Sample code:

#include <cion.h>

{
    int ret;

    ret = cion_client_remove_disconnected_cb(client,
            _cion_client_disconnected_cb);
}

Removes callback function to receive payload.

Since :

6.5

Parameters:

[in]	client	The Cion client handle
[in]	cb	The callback function

Returns:

0 on success, otherwise a negative error value

Return values:

CION_ERROR_NONE	Successful
CION_ERROR_INVALID_PARAMETER	Invalid parameter

See also:

cion_client_payload_received_cb()

cion_client_add_payload_received_cb()

Sample code:

#include <cion.h>

{
    int ret;

    ret = cion_client_remove_payload_received_cb(client,
            _cion_client_payload_received_cb);
}

Sends the data.

Since :

6.5

Remarks:

return_data must be released using free().

Parameters:

[in]	client	The Cion client handle
[in]	data	The data to send
[in]	data_size	The size of data
[in]	timeout	The time(milliseconds) to check time out
[out]	return_data	The returned data
[out]	return_data_size	The size of returned data

Returns:

0 on success, otherwise a negative error value

Return values:

CION_ERROR_NONE	Successful
CION_ERROR_INVALID_PARAMETER	Invalid parameter
CION_ERROR_IO_ERROR	IO error
CION_ERROR_TIMED_OUT	Timed out
CION_ERROR_INVALID_OPERATION	Invalid operation
CION_ERROR_OUT_OF_MEMORY	Out of memory

Sample code:

#include <cion.h>

{
    int ret;
    unsigned char *return_data = NULL,
    unsigned int return_size;

    ret = cion_client_send_data(client, "senddata", 8, 10,
            &return_data, &return_size);
}

Sends the payload asynchronously.

Since :

6.5

Parameters:

[in]	client	The Cion client handle
[in]	payload	The payload handle
[in]	cb	The callback function
[in]	user_data	The user data

Returns:

0 on success, otherwise a negative error value

Return values:

CION_ERROR_NONE	Successful
CION_ERROR_INVALID_PARAMETER	Invalid parameter
CION_ERROR_INVALID_OPERATION	Invalid Operation

See also:

cion_payload_create()

cion_client_payload_async_result_cb()

Sample code:

#include <cion.h>

{
    int ret;

    ret = cion_client_send_payload_async(client, payload,
            _cion_client_payload_async_result_cb, NULL);
}

Stops to discovery Cion server.

Since :

6.5

Parameters:

[in]

client

The Cion client handle

Returns:

0 on success, otherwise a negative error value

Return values:

CION_ERROR_NONE	Successful
CION_ERROR_INVALID_PARAMETER	Invalid parameter
CION_ERROR_INVALID_OPERATION	Invalid

Sample code:

#include <cion.h>

{
    int ret;

    ret = cion_client_stop_discovery(client);
}

Tries to discover a Cion server.

Since :

6.5

Privilege Level:

public

Privilege:

http://tizen.org/privilege/d2d.datasharing
http://tizen.org/privilege/internet

Remarks:

Tries to discover the server with service name that the client handle has.

Parameters:

[in]	client	The Cion client handle
[in]	cb	The callback function
[in]	user_data	The user data

Returns:

0 on success, otherwise a negative error value

Return values:

CION_ERROR_NONE	Successful
CION_ERROR_PERMISSION_DENIED	Permission denied
CION_ERROR_INVALID_PARAMETER	Invalid parameter
CION_ERROR_ALREADY_IN_PROGRESS	Already in progress
CION_ERROR_IO_ERROR	IO error

See also:

cion_client_server_discovered_cb()

Sample code:

#include <cion.h>

{
    int ret;

    ret = cion_client_try_discovery(client,
            _cion_client_server_discovered_cb, NULL);
}