navigator_invoke_invocation_get_type()

Get the type from an invocation.

Synopsis:

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

Since:

BlackBerry 10.0.0

Arguments:

invocation

A pointer to the navigator_invoke_invocation_t structure whose type 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_type() function extracts the MIME type of a given navigator_invoke_invocation_t structure. The type member is used by the brokering system and invocation framework to identify the MIME type of the data an invoked handler is meant to perform an action on (see the navigator_invoke_invocation_set_type() 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 invocation type if one was provided by the sender, NULL otherwise.