menu_invocation_get_data_length()

Retrieve the data length from a menu invocation.

Synopsis:

#include "bps/menu.h"
 
BPS_API int menu_invocation_get_data_length(const menu_invocation_t *invocation)

Since:

BlackBerry 10.0.0

Arguments:

invocation

A pointer to the menu_invocation_t structure whose data_length member you want to retrieve.

Library:

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

Description:

The menu_invocation_get_data_length() function extracts the length in bytes of the data of a given menu_invocation_t structure. The data_length member is used by the invocation handler to identify the size of the data the invoked handler is to perform an action on (see the menu_invocation_get_data() function for further details).

Returns:

The size in bytes of the invocation data if one was provided by the sender, -1 otherwise.