menu_invocation_get

Retrieve the target of the menu invocation.

Synopsis:

#include "bps/menu.h"

BPS_API const char* menu_invocation_get_target(menu_invocation_t *invocation)

Since:

BlackBerry 10.0.0

Arguments:

invocation: The menu invocation to retrieve the target from. The identifier of the target (as stated in its BAR manifest) to which invocation is delivered. If the target is supplied, then brokering is bypassed and an attempt is made to invoke the specified target.

Library:

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

Description:

The menu_invocation_get_target() function extracts the target of the given menu invocation object. The function doesn't copy the data and the returned values are released once the bps_get_event() function is called again.

Returns:

The target inside the menu invocation, NULL if there is no target.