navigator_invoke_viewer_set_window_id()

#include <bps/navigator_invoke.h>
 

BPS_API int navigator_invoke_viewer_set_window_id(navigator_invoke_viewer_t *viewer,
                                                  const char *window_id) BPS_DEPRECATED

Since:

BlackBerry 10.0.0

Arguments:

viewer

A pointer to the navigator_invoke_viewer_t structure whose window_id you want to set.

window_id

The window ID you want to associate with a window created by the viewer. The value can be any string of characters. For example, "window#123" is an acceptable window ID.

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_viewer_set_window_id() function sets the window ID of a given navigator_invoke_viewer_t structure. The window_id member identifies a window created by the viewer. You may use this for application to viewer communication. You must set a window_id to all navigator_invoke_viewer_t structures.

Returns:

BPS_SUCCESS upon success, BPS_FAILURE with errno set otherwise.