failure_cb_t

The failure callback function.

Synopsis:

#include <ids.h>
 
typedef void(* failure_cb_t)(ids_request_id_t request_id, ids_result_t result, const char *info, void *cb_data);

Arguments:

request_id

The request id that matches the one returned during the request.

result

The failure result code of the request.

info

Information about the failure that is specific to the identity provider. It's possible that some identity providers have not populated this information. See your specific identity provider for information on the contents of this field.

cb_data

The cb_data pointer passed during the request.

Since:

BlackBerry 10.2.0

Library:

libids (For the qcc command, use the -l ids option to link against this library)

Description:

Each function has a number of listed result codes that can occur while processing the request, but it is a good practice to implement this callback to handle additional/new results. Implementing the failure callback can provide a generic check for failure, and help maintain future compatibility.