menu_invocation_get

Retrieve the URI pointing to the invocation data.

Synopsis:

#include "bps/menu.h"

BPS_API const char* menu_invocation_get_uri(menu_invocation_t *invocation)

Since:

BlackBerry 10.0.0

Arguments:

invocation: The menu invocation to retrieve the URI from.

Library:

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

Description:

The menu_invocation_get_uri() function extracts the URI pointing to the invocation data. If the URI is not provided then this implies the "data://local" URI indicating that the invocation data is provided in-band retrieved through menu_invocation_get_data() function. The function doesn't copy the data and the returned values are released once the bps_get_event() function is called again.

Returns:

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