navigator_invoke_query_set_target_type

Set the target type mask of a query.

Synopsis:

#include <bps/navigator_invoke.h>

BPS_API int navigator_invoke_query_set_target_type_mask(navigator_invoke_query_t *query,
                                                        int target_type_mask)

Since:

BlackBerry 10.0.0

Arguments:

query: A pointer to the navigator_invoke_query_t structure whose target_type_mask member you want to set.

target_type_mask: A target type corresponding to an entry in the navigator_invoke_target_type_t enumeration. The NAVIGATOR_INVOKE_TARGET_TYPE_SERVICE value is reserved for future use.

Library:

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

Description:

The navigator_invoke_query_set_target_type_mask() function sets the target type mask of a given navigator_invoke_query_t structure. The target_type_mask member is a bitwise OR value that determines which targets the invocation query should include in its results.

The invoke target type values you can use to set this member are:

NAVIGATOR_INVOKE_TARGET_TYPE_APPLICATION
NAVIGATOR_INVOKE_TARGET_TYPE_CARD
NAVIGATOR_INVOKE_TARGET_TYPE_SERVICE
NAVIGATOR_INVOKE_TARGET_TYPE_HEADLESS
a bitwise OR of any combination of the above values.

If you don't assign a target_type_mask member or assign NAVIGATOR_INVOKE_TARGET_TYPE_UNSPECIFIED to a query, then all the target types will be considered in the query.

See the navigator_invoke_target_type_t enumeration for details.

Returns:

BPS_SUCCESS upon success, BPS_FAILURE with errno set otherwise.