menu_invocation_get

Retrieve the action of the menu invocation.

Synopsis:

#include "bps/menu.h"

BPS_API const char* menu_invocation_get_action(menu_invocation_t *invocation)

Since:

BlackBerry 10.0.0

Arguments:

invocation: The menu invocation to retrieve the action from. The identifier of the action to be performed by the target. Omitting action implies brokering applies to any action supported for the specified type or that the target infers the action.

Library:

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

Description:

The menu_invocation_get_action() function extracts the action 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 action inside the menu invocation, NULL if there is no action.