navigator_invoke_query_result_target_get_key()

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)

Arguments:

target

The navigator_invoke_query_result_target_t structure whose key member you want to retrieve.

Library:

libbps

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.

Related links