Request cancellation

Cancel pending requests. More...

Detailed Description

Cancel pending requests.

Module. Specify USEMODULE += unicoap_client_cancellation in your application's Makefile.

When you call unicoap_send_request_async, its return value is a token you use to refer to this request ('refno'). Pass the refno you obtain this way to unicoap_cancel_request to cancel the request. It is safe to pass a refno whose corresponding request has already failed or finished successfully.

Cancelling a request
int	unicoap_cancel_request (int refno)
	Cancels request with reference number.

Function Documentation

unicoap_cancel_request()

int unicoap_cancel_request

(

int

refno

)

Cancels request with reference number.

Parameters

refno

Reference number

Requires Request cancellation The client callback will be called with -ECANCELLED

Returns

Zero on success, negative error number otherwise

Return values

-EINVAL	Invalid refno
-ENOENT	No request with given refno is known