navigator_invoke_timer_registration_get_specific_time()

Retrieve the specific time from a timer registration structure.

Synopsis:

#include <bps/navigator_invoke.h>
 
BPS_API const navigator_invoke_specific_time_t* navigator_invoke_timer_registration_get_specific_time(const navigator_invoke_timer_registration_t *reg)

Since:

BlackBerry 10.3.0

Arguments:

reg

The navigator_invoke_timer_registration_t structure to query.

Library:

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

Description:

This function retrieves the specific time from a navigator_invoke_timer_registration_t structure. If no specific time is set in the structure, then NULL is returned.

The registration structure continues to own the returned navigator_invoke_specific_time_t structure. The application must not destroy the returned structure.

Returns:

A specific time, or NULL if one was not set. errno will be set in case of failure.