menu_invocation_get_metadata()

Retrieve the metadata of the menu invocation.

Synopsis:

#include "bps/menu.h"
 
BPS_API const char* menu_invocation_get_metadata(menu_invocation_t *invocation)

Since:

BlackBerry 10.0.0

Arguments:

invocation

The menu invocation to retrieve the metadata from.

Library:

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

Description:

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