navigator_invoke_query_result_action_get_name()

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)

Arguments:

action

The navigator_invoke_query_result_action_t structure whose name member you want to retrieve.

Library:

libbps

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.

Related links