navigator_invoke_event_get_window

The use of viewers has been deprecated - use applications or cards as invocation targets instead.

Synopsis:

#include <bps/navigator_invoke.h>

BPS_API const char* navigator_invoke_event_get_window_id(bps_event_t *event) BPS_DEPRECATED

Since:

BlackBerry 10.0.0

Arguments:

event: The NAVIGATOR_INVOKE_VIEWER_STOPPED event triggered by the terminated viewer.

Library:

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

Description:

Deprecated:

The use of viewers has been deprecated - use applications or cards as invocation targets instead.

The navigator_invoke_event_get_window_id() function extracts the window ID of a given viewer that has been terminated. The window_id member is used by the parent application to identify the viewer that was terminated. Call this function in the parent application upon receiving a NAVIGATOR_INVOKE_VIEWER_STOPPED event to identify the terminated viewer. This function doesn't copy data and the returned values are released once the bps_get_event() function is called again.

Returns:

The window ID of the terminated viewer, NULL with errno set otherwise.