navigator_invoke_query_result_action_get

Get the name of an action from an invocation query result.

Synopsis:

#include <bps/navigator_invoke.h>

BPS_API const char* navigator_invoke_query_result_action_get_name(const navigator_invoke_query_result_action_t *action)

Since:

BlackBerry 10.0.0

Arguments:

action: The navigator_invoke_query_result_action_t structure whose name 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_query_result_action_get_name() function extracts the action name of a given navigator_invoke_query_result_action_t structure. The name member is used by the query result handler to identify a given action that is supported for the specified query. This function doesn't copy members and the returned values are released once the bps_get_event() function is called again. You must call this function to display the returned action value(s).

Each action name conforms to the following guidelines:

Maximum 50 characters
Action: [Domain][Sub-domain]
Sub-domain: NUL | .[Domain][Sub-domain]
Domain: [a-zA-Z]([a-zA-Z0-9_])*

Example: "bb.action.SHARE"

Returns:

The name of the given action, in the "[Domain][Sub-domain]" format (see description for further information), NULL otherwise.