navigator_invoke_query_result_target_get

Get the key of a target for an action.

Synopsis:

#include <bps/navigator_invoke.h>

BPS_API const char* navigator_invoke_query_result_target_get_key(const navigator_invoke_query_result_target_t *target)

Since:

BlackBerry 10.0.0

Arguments:

target: The navigator_invoke_query_result_target_t structure whose key 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_target_get_key() function extracts the target key of a given navigator_invoke_query_result_target_t structure. The key member is an identifier to a target (as stated in its BAR manifest) that is capable of performing the specified action. This function doesn't copy members and the returned values are released once the bps_get_event() function is called again. You must call this function to display returned target value(s).

Each target key 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.invoke.target"

Returns:

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