navigator_invoke_invocation_set_data()

#include <bps/navigator_invoke.h>
 

BPS_API int navigator_invoke_invocation_set_data(navigator_invoke_invocation_t *invocation,
                                                 const void *data,
                                                 int data_length)

Since:

BlackBerry 10.0.0

Arguments:

invocation

A pointer to the navigator_invoke_invocation_t structure whose data you want to set.

data

The arbitrary data being sent to the invocation handler. The value of this member can take the form of any binary data.

data_length

The size of the data member in bytes.

Library:

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

Description:

The navigator_invoke_invocation_set_data() function sets the data and data_length of a given navigator_invoke_invocation_t structure. The data member is the data the invoked handler is to perform an action on. Upon sending the invocation, the data is delivered to the target in its unchanged form.

If you don't call this function, the action and/or type information (which can be set using the navigator_invoke_invocation_set_action() and navigator_invoke_invocation_set_type() functions respectively) must be sufficient to carry out the invocation.

Returns:

BPS_SUCCESS upon success, BPS_FAILURE with errno set otherwise.