navigator_invoke_invocation_set

Set the URI of an invocation.

Synopsis:

#include <bps/navigator_invoke.h>

BPS_API int navigator_invoke_invocation_set_uri(navigator_invoke_invocation_t *invocation,
                                                const char *uri)

Since:

BlackBerry 10.0.0

Arguments:

invocation: A pointer to the navigator_invoke_invocation_t structure whose uri member you want to set.

uri: The URI to the data being sent to the invocation handler. The value of this member should be a percent-encoded URI. For example, file:///accounts/1000/appdata/com.example.application.123456789123456789123456789/data/image%201.jpg

Library:

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

Description:

The navigator_invoke_invocation_set_uri() function sets the URI pointing to the data of a given navigator_invoke_invocation_t structure. The uri member identifies the location of the data the invoked handler is to perform an action on.

If you don't call this function, the URI is assumed to be "data://local", indicating that the invocation data is provided through the data member (using the navigator_invoke_invocation_set_data() function).

Returns:

BPS_SUCCESS upon success, BPS_FAILURE with errno set otherwise.