navigator_invoke_query_result_action_get_default_target()

Get the default target of an action from an invocation query result.

Synopsis:

#include <bps/navigator_invoke.h>
 
BPS_API const char* navigator_invoke_query_result_action_get_default_target(const navigator_invoke_query_result_action_t *action)

Since:

BlackBerry 10.0.0

Arguments:

action

The navigator_invoke_query_result_action_t structure whose default_target member you want to retrieve.

Library:

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

Description:

The navigator_invoke_query_result_action_get_default_target() function extracts the default target of a given navigator_invoke_query_result_action_t structure. The default_target member is the name of a target handler that is considered as the default provider for the given action. This function doesn't copy members and the returned values are released once the bps_get_event() function is called again.

Each action default_target conforms to the following guidelines:
  • Maximum 50 characters
  • Target: [Domain][Sub-domain]
  • Sub-domain: NUL | .[Domain][Sub-domain]
  • Domain: [a-zA-Z]([a-zA-Z0-9_])*

Example: "com.example.target"

Returns:

The default target of the given action, in the "[Domain][Sub-domain]" format (see description for further information), NULL otherwise.