navigator_invoke_query_create()

Create an invoke query structure and allocate all necessary memory.

Synopsis:

#include <bps/navigator_invoke.h>
 
BPS_API int navigator_invoke_query_create(navigator_invoke_query_t **query)

Since:

BlackBerry 10.0.0

Arguments:

query

The navigator_invoke_query_t structure to populate.

Library:

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

Description:

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

Returns:

BPS_SUCCESS upon success, BPS_FAILURE with errno set otherwise.