Timeline pins showing alarms. More...

Functions
status_t	alarm_pin_add (time_t alarm_time, AlarmId id, AlarmType type, AlarmKind kind, Uuid *uuid_out)
	Add a pin for an alarm to the timeline.

void	alarm_pin_remove (Uuid *alarm_id)
	Remove an alarm pin from the timeline.

status_t	alarm_pin_remove_untracked_future (time_t now, const Uuid *tracked, size_t tracked_count)
	Remove future alarm pins that no alarm tracks anymore.

Detailed Description

Timeline pins showing alarms.

Pins are created from the watch with the alarms data source as parent, and an action that opens the alarm in the alarms app.

Function Documentation

Add a pin for an alarm to the timeline.

Parameters

	alarm_time	Time of the pin.
	id	Alarm the pin belongs to.
	type	Alarm type, selects the pin title.
	kind	Alarm recurrence, shown on the pin.
[out]	uuid_out	ID of the new pin, may be NULL.

Return values

S_SUCCESS	Pin added.
E_OUT_OF_MEMORY	The pin could not be created.

void alarm_pin_remove ( Uuid * alarm_id )

Remove an alarm pin from the timeline.

Parameters

alarm_id ID of the pin to remove.

status_t alarm_pin_remove_untracked_future	(	time_t	now,
		const Uuid *	tracked,
		size_t	tracked_count
	)

Remove future alarm pins that no alarm tracks anymore.

Parameters

now	Current time; pins before it are kept.
tracked	IDs of the pins still owned by alarms.
tracked_count	Number of entries in `tracked`.

Return values

S_SUCCESS All untracked future pins were removed.