navigator_invoke_viewer_create()

#include <bps/navigator_invoke.h>
 

BPS_API int navigator_invoke_viewer_create(navigator_invoke_viewer_t **viewer,
                                           navigator_invoke_invocation_t *invocation) BPS_DEPRECATED

Since:

BlackBerry 10.0.0

Arguments:

viewer

The navigator_invoke_viewer_t structure to populate.

invocation

The navigator_invoke_invocation_t structure to associate with the given viewer. The invocation member cannot be NULL. When you call this function, ownership of the navigator_invoke_invocation_t structure is passed to the navigator_invoke_viewer_t structure, and is destroyed once you call the navigator_invoke_viewer_destroy() function. For this reason, don't call the navigator_invoke_invocation_destroy() function once you call the navigator_invoke_viewer_create() function.

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_create() function creates an instance of a navigator_invoke_viewer_t structure called viewer to be used by the invocation framework, and associates it to a navigator_invoke_invocation_t invocation structure. Destroy all viewer instances created through this function once they are no longer needed by using the navigator_invoke_viewer_destroy() function to prevent memory leaks.

Returns:

BPS_SUCCESS upon success, BPS_FAILURE with errno set otherwise.