navigator_invoke_invocation_get_data_length()

Get the data length from an invocation.

Synopsis:

#include <bps/navigator_invoke.h>
 
BPS_API int navigator_invoke_invocation_get_data_length(const navigator_invoke_invocation_t *invocation)

Since:

BlackBerry 10.0.0

Arguments:

invocation

A pointer to the navigator_invoke_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 navigator_invoke_invocation_get_data_length() function extracts the length in bytes of the data of a given navigator_invoke_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 navigator_invoke_invocation_set_data() function for further details). This function doesn't copy members and the returned values are released once the navigator_invoke_invocation_t structure is destroyed with the navigator_invoke_invocation_destroy() function.

Returns:

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