navigator_invoke_specific_time_create()

Create an opaque structure to register a specific time trigger.

Synopsis:

#include <bps/navigator_invoke.h>

BPS_API int navigator_invoke_specific_time_create(navigator_invoke_specific_time_t **specific_time)

Since:

BlackBerry 10.3.0

Arguments:

specific_time: A pointer to the navigator_invoke_specific_time_t structure to populate.

Library:

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

Description:

This function creates an instance of a navigator_invoke_specific_time_t structure to use for timer registration. Destroy each invocation instance created by this function once it is no longer needed by calling navigator_invoke_specific_time_destroy() to prevent memory leaks.

Returns:

BPS_SUCCESS upon success, BPS_FAILURE with errno set otherwise.