navigator_invoke_viewer_get_window_id()

#include <bps/navigator_invoke.h>
 

BPS_API const char* navigator_invoke_viewer_get_window_id(const navigator_invoke_viewer_t *viewer) BPS_DEPRECATED

Since:

BlackBerry 10.0.0

Arguments:

viewer

A pointer to the navigator_invoke_viewer_t structure whose window_id member you want to retrieve.

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_get_window_id() function extracts the window ID of a given navigator_invoke_viewer_t structure. The window_id member is used to identify the window created by a viewer invocation (see the navigator_invoke_viewer_set_window_id() function for further details). This function doesn't copy members and the returned values are released once the navigator_invoke_viewer_t structure is destroyed with the navigator_invoke_viewer_destroy() function.

Returns:

The invocation viewer window ID if was provided by the sender, NULL with errno set otherwise.