navigator_invoke_invocation_destroy()

Deallocate the memory used by an invocation structure.

Synopsis:

#include <bps/navigator_invoke.h>
 
BPS_API int navigator_invoke_invocation_destroy(navigator_invoke_invocation_t *invocation)

Since:

BlackBerry 10.0.0

Arguments:

invocation

The navigator_invoke_invocation_t structure to deallocate.

Library:

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

Description:

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

Returns:

BPS_SUCCESS upon success, BPS_FAILURE with errno set otherwise.