navigator_invoke_viewer_destroy()
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
Since:
BlackBerry 10.0.0
Arguments:
- viewer
-
The navigator_invoke_viewer_t structure to deallocate.
Library:
libbpsDescription:
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.
Returns:
BPS_SUCCESS upon success, BPS_FAILURE with errno set otherwise.