prg_calendar_next_event_get()
Abstract
Remove the next scheduled event from the calendar.
Syntax
prg_calendar_next_event_get (calendar_handle, time_ptr)
| Argument | Type | Description |
|---|---|---|
calendar_handle |
PrgT_Calendar_Handle |
object to query |
time_ptr |
double * |
scheduled time of the returned event |
Return Type
void *
Data associated with the event removed from the calendar.
Header
prg_calendar.h
Details
Events in the calendar are accessed in time-order fashion. Accessing an event removes that event from the calendar (after which prg_calendar_event_remove() can no longer be invoked for that event's handle).
Accessing an event returns the data associated with that event and the time at which the event was scheduled.