navigator_invoke_invocation_create()

Create an invocation structure and allocate all necessary memory.

Synopsis:

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

Since:

BlackBerry 10.0.0

Arguments:

invocation

The navigator_invoke_invocation_t structure to populate.

Library:

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

Description:

The navigator_invoke_invocation_create() function creates an instance of a navigator_invoke_invocation_t structure called invocation to be used by the invocation framework. Destroy all invocation instances created through this function once they are no longer needed by using the navigator_invoke_invocation_destroy() function to prevent memory leaks.

Returns:

BPS_SUCCESS upon success, BPS_FAILURE with errno set otherwise.