navigator_invoke_set_filters()

Sends the set target filters request to the invocation framework.

Synopsis:

#include <bps/navigator_invoke.h>

BPS_API int navigator_invoke_set_filters(const char *id,
                                         const char *target,
                                         const char *filters[],
                                         size_t filters_count)

Since:

BlackBerry 10.0.0

Arguments:

id: The ID you want to display on the delivery receipt response. This value must be in numerical format. For example, a valid id would be "42".

target: The target key of the target whose filters are to be set.

filters: The array of filters to be set.

filters_count: The size of the filters array.

Library:

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

Description:

The navigator_invoke_set_filters() function sends the set target filters request to the invocation framework.

Returns:

BPS_SUCCESS upon success, BPS_FAILURE with errno set otherwise.