navigator_invoke_event_get

Get the key of an invoked target from the BPS event.

Synopsis:

#include <bps/navigator_invoke.h>

BPS_API const char* navigator_invoke_event_get_target(bps_event_t *event)

Since:

BlackBerry 10.0.0

Arguments:

event: The NAVIGATOR_INVOKE_TARGET_RESULT event triggered by the invoked target.

Library:

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

Description:

The navigator_invoke_event_get_target() function extracts the target key of an invoked target application. The target key is an identifier to a target (as stated in its BAR manifest) that had been invoked. Call this function in the application upon receiving a NAVIGATOR_INVOKE_TARGET_RESULT event to identify the target that was invoked. This function doesn't copy data and the returned value is released once the bps_get_event() function is called again.

Returns:

The key of the target that was invoked, NULL with errno set otherwise.