navigator_invoke_event_get_group

Get the group ID of an invocation source application from the BPS event.

Synopsis:

#include <bps/navigator_invoke.h>

BPS_API int64_t navigator_invoke_event_get_group_id(bps_event_t *event)

Since:

BlackBerry 10.0.0

Arguments:

event: The NAVIGATOR_INVOKE_TARGET event triggered by the source application.

Library:

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

Description:

The navigator_invoke_event_get_group_id() function extracts the group ID of an invocation source application. The group ID is an identifier to the client application that sent the invocation. Call this function in the application upon receiving a NAVIGATOR_INVOKE_TARGET event to identify the source of the invocation.

Returns:

The group ID of the invocation source application upon success, BPS_FAILURE with errno set otherwise.