navigator_invoke_recurrence_rule_set_minutes_of_hour()

#include <bps/navigator_invoke.h>
 

BPS_API int navigator_invoke_recurrence_rule_set_minutes_of_hour(navigator_invoke_recurrence_rule_t *recurrence_rule,
                                                                 int minutes_of_hour[],
                                                                 size_t count)

Since:

BlackBerry 10.3.1

Arguments:

recurrence_rule

The navigator_invoke_recurrence_rule_t structure to modify.

minutes_of_hour

An array containing the minutes to be set, within the range 0 to 59, inclusive.

count

The size of the minutes_of_hour array.

Library:

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

Description:

This function sets the minutes_of_hour of a navigator_invoke_recurrence_rule_t structure.

Starting from the start date of the recurrence rule, the trigger will be applied at minutes_of_hour per the frequency of the recurrence rule, as allowed by other recurrence conditions, until the count limit or date limit are reached, if applicable.

This function doesn't transfer ownership of minutes_of_hour to recurrence_rule. recurrence_rule keeps a copy of minutes_of_hour. If applicable, minutes_of_hour must be freed to avoid memory leaks. If you change the value of minutes_of_hour calling this function, you must call this function again to use the new value.

Returns:

BPS_SUCCESS upon success, BPS_FAILURE with errno set otherwise.