navigator_invoke_invocation_set_target_type

Set the target type mask of an invocation.

Synopsis:

#include <bps/navigator_invoke.h>

BPS_API int navigator_invoke_invocation_set_target_type_mask(navigator_invoke_invocation_t *invoke,
                                                             int target_type_mask)

Since:

BlackBerry 10.0.0

Arguments:

invoke: A pointer to the navigator_invoke_invocation_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.

Library:

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

Description:

The navigator_invoke_invocation_set_target_type_mask() function sets the target type mask of a given navigator_invoke_invocation_t structure. The target_type_mask member is a bitwise-OR value that indicates which targets the invocation selection should include: applications, cards and/or services.

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.

See the navigator_invoke_target_type_t enumeration for details.

If you don't assign a target_type_mask member, or you assign NAVIGATOR_INVOKE_TARGET_TYPE_UNSPECIFIED to an invocation, then all of the target types will be considered in the brokering system.

Returns:

BPS_SUCCESS upon success, BPS_FAILURE with errno set otherwise.