navigator_invoke_viewer

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

Synopsis:

#include <bps/navigator_invoke.h>

BPS_API int navigator_invoke_viewer_destroy(navigator_invoke_viewer_t *viewer) BPS_DEPRECATED

BlackBerry 10.0.0

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

Deprecated:

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

The navigator_invoke_viewer_destroy() function deallocates any memory set to a given viewer. Use this function to deallocate memory used by a navigator_invoke_viewer_t structure (created by the navigator_invoke_viewer_create() function) that's no longer in use. Failing to do so will result in a memory leak.

Note that calling this function will also destroy the navigator_invoke_invocation_t structure associated with the given navigator_invoke_viewer_t structure. For this reason, don't call the navigator_invoke_invocation_destroy() function on a navigator_invoke_invocation_t structure that has been associated with a viewer using the navigator_invoke_viewer_create() function.

BPS_SUCCESS upon success, BPS_FAILURE with errno set otherwise.