navigator_invoke_query_result_action_get_target()

#include <bps/navigator_invoke.h>
 

BPS_API const navigator_invoke_query_result_target_t* navigator_invoke_query_result_action_get_target(const navigator_invoke_query_result_action_t *action,
                                                                      int index)

Since:

BlackBerry 10.0.0

Arguments:

action

The navigator_invoke_query_result_action_t structure holding the target values.

index

The numerical index value of the navigator_invoke_query_result_target_t structure inside the given navigator_invoke_query_result_action_t structure.

Library:

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

Description:

The navigator_invoke_query_result_action_get_target() function extracts one of the navigator_invoke_query_result_target_t structures inside of a navigator_invoke_query_result_action_t structure, identified by a given index value. The navigator_invoke_query_result_target_t target structures contained are considered viable targets to perform the given action. This function doesn't copy members and the returned values are released once the bps_get_event() function is called again.

Returns:

The pointer to the returned target, NULL otherwise.