navigator_invoke_event_get

Get the dname of an invocation source application from the BPS event.

Synopsis:

#include <bps/navigator_invoke.h>

BPS_API const char* navigator_invoke_event_get_dname(bps_event_t *event)

Since:

BlackBerry 10.0.0

Arguments:

event: The NAVIGATOR_INVOKE_TARGET event triggered by the source application.

Library:

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

Description:

The navigator_invoke_event_get_dname() function extracts the dname of an invocation source application. The dname is an identifier to a package, and contains the package name and package ID attributes. Call this function in the application upon receiving a NAVIGATOR_INVOKE_TARGET event to identify the source of the invocation. This function doesn't copy data and the returned value is released once the bps_get_event() function is called again.

Returns:

The dname of the invocation source application.