menu_request_set_target_type_mask()

Set the target type mask of the menu request.

Synopsis:

#include "bps/menu.h"
 
BPS_API int menu_request_set_target_type_mask(menu_request_t *request,
                                              int target_type_mask)

Since:

BlackBerry 10.0.0

Arguments:

request

The request to update.

target_type_mask

The target type to set.

Library:

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

Description:

The menu_request_set_target_type_mask() function indicates whether to include targets of type application, service, or card in the results set. Including the value NAVIGATOR_INVOKE_TARGET_TYPE_SELF indicates that a target will be included even if it is the same as the requesting client.

The expected values are:
  • NAVIGATOR_INVOKE_TARGET_TYPE_APPLICATION or
  • NAVIGATOR_INVOKE_TARGET_TYPE_CARD or
  • NAVIGATOR_INVOKE_TARGET_TYPE_SERVICE or
  • NAVIGATOR_INVOKE_TARGET_TYPE_HEADLESS or
  • NAVIGATOR_INVOKE_TARGET_TYPE_SELF
  • a combination of the above

For example, NAVIGATOR_INVOKE_TARGET_TYPE_APPLICATION | NAVIGATOR_INVOKE_TARGET_TYPE_CARD would include targets of type application and card.

Returns:

BPS_SUCCESS upon success, BPS_FAILURE with errno set otherwise.