|  |  |  | evolution-kolab_calendar Reference Manual |  | 
|---|---|---|---|---|
| Top | Description | ||||
| KolabUtilCalendarCacheKolabUtilCalendarCache — Utility methods for Evolution-Kolab calendar backend implementation with ECalBackendCache side effects. | 
struct KolabUtilCalendarCacheClass; gboolean kolab_util_calendar_cache_assure_uid_on_ecalcomponent (ECalBackendSync *backend,ECalBackendCache *cache,KolabMailAccess *koma,ECalComponent *ecalcomp,gboolean bulk,GCancellable *cancellable,GError **error); ECalComponent * kolab_util_calendar_cache_get_object (ECalBackendSync *backend,ECalBackendCache *cal_cache,KolabMailAccess *koma,const gchar *uid,gboolean bulk,GCancellable *cancellable,GError **error); ECalComponent * kolab_util_calendar_cache_get_tz (ECalBackendCache *cache,ECalComponent *comp); ECalComponent * kolab_util_calendar_cache_get_tz_by_id (ECalBackendCache *cache,const gchar *tzid); ECalComponent * kolab_util_calendar_cache_remove_instance (ECalBackendCache *cal_cache,CalObjModType mod,ECalComponent *ecalcomp,const gchar *uid,const gchar *rid); gboolean kolab_util_calendar_cache_update_object (ECalBackendSync *backend,ECalBackendCache *cache,KolabMailAccess *koma,const gchar *uid,gboolean bulk,GCancellable *cancellable,GError **error); gboolean kolab_util_calendar_cache_update_on_query (ECalBackendSync *backend,ECalBackendCache *cache,KolabMailAccess *koma,const gchar *query,GCancellable *cancellable,GError **error);
The methods in KolabUtilCalendarCache are supposed to update the ECalBackendCache as a side effect to their primary task or retrieve data from the cache to fulfill its task.
struct KolabUtilCalendarCacheClass {
	GObjectClass parent_class;
};
gboolean kolab_util_calendar_cache_assure_uid_on_ecalcomponent (ECalBackendSync *backend,ECalBackendCache *cache,KolabMailAccess *koma,ECalComponent *ecalcomp,gboolean bulk,GCancellable *cancellable,GError **error);
Sets a new uid to ecalcomp and assures, that it is not used in koma, so far.
| 
 | an ECalBackendSync | 
| 
 | An ECalBackendCache. | 
| 
 | A KolabMailAccess instance. | 
| 
 | An ECalComponent. | 
| 
 | Whether or not this is a mass operation. | 
| 
 | A cancellation stack. | 
| 
 | A GError placeholder. | 
| Returns : | On Success TRUE is returned. | 
ECalComponent * kolab_util_calendar_cache_get_object (ECalBackendSync *backend,ECalBackendCache *cal_cache,KolabMailAccess *koma,const gchar *uid,gboolean bulk,GCancellable *cancellable,GError **error);
Retrieves the the object referenced by uid from the given cal_cache. If
none is found, NULL is returned.
| 
 | an ECalBackendSync | 
| 
 | A Cache. | 
| 
 | A KolabMailAccess object. | 
| 
 | The uid to search for. | 
| 
 | Whether or not this is a mass operation. | 
| 
 | A cancellation stack. | 
| 
 | GError placeholder. | 
| Returns : | A new ECalComponent containing the object. Unref if no longer needed. | 
ECalComponent * kolab_util_calendar_cache_get_tz (ECalBackendCache *cache,ECalComponent *comp);
| 
 | A Cache. | 
| 
 | An ECalComponent (Some calendar entry).
.
The tzid of the ECalComponent DTSTART property is used to extract timezone
information from the supplied backend cache. The ECalComponent returned
should be freed, using g_object_unref(), once no longer needed. Note:
Events may not provide a timezone/TZID (like UTC)! | 
| Returns : | An ECalComponent containing a timezone or NULL if none is found.. | 
ECalComponent * kolab_util_calendar_cache_get_tz_by_id (ECalBackendCache *cache,const gchar *tzid);
ECalComponent * kolab_util_calendar_cache_remove_instance (ECalBackendCache *cal_cache,CalObjModType mod,ECalComponent *ecalcomp,const gchar *uid,const gchar *rid);
Removes an instance of an event with recurrence.
| 
 | An ECalBackendCache. | 
| 
 | CalObjModType to apply to the remove request. | 
| 
 | The object before the removal took place. | 
| 
 | The UID of the recurring event. | 
| 
 | The recurrence ID of the recurrence. | 
| Returns : | The modified component. | 
gboolean kolab_util_calendar_cache_update_object (ECalBackendSync *backend,ECalBackendCache *cache,KolabMailAccess *koma,const gchar *uid,gboolean bulk,GCancellable *cancellable,GError **error);