| Top |
This class communicates with
GError * e_data_cal_create_error (EDataCalCallStatus status,const);gchar *custom_msg
status |
||
custom_msg |
Custom message to use for the error. When NULL,
then uses a default message based on the |
NULLstatus
is Success,
or a newly allocated GError, which should be freed
with g_error_free()
[nullable][transfer full]
Since: 2.32
GError * e_data_cal_create_error_fmt (EDataCalCallStatus status,const,gchar *custom_msg_fmt...);
Similar as e_data_cal_create_error(), only here, instead of custom_msg,
is used a printf()
status |
||
custom_msg_fmt |
message format, or |
[nullable] |
... |
arguments for the format |
NULLstatus
is Success,
or a newly allocated g_error_free()status
, when custom_msg_fmt
is NULL
[nullable][transfer full]
Since: 2.32
constgchar * e_data_cal_status_to_string (EDataCalCallStatus status);
Since: 2.32
EDataCal * e_data_cal_new (struct _ECalBackend *backend,,GDBusConnection *connectionconst,gchar *object_path);GError **error
Creates a new connection
at object_path
. The backend
. If the Calendar
interface fails to export, the function sets error
and returns NULL
backend |
an ECalBackend |
|
connection |
a |
|
object_path |
object path for the D-Bus interface |
|
error |
return location for a |
struct _ECalBackend *
e_data_cal_ref_backend (EDataCal *cal);
Returns the ECalBackend to which incoming remote method invocations are being forwarded.
The returned ECalBackend is referenced for thread-safety and should
be unreferenced with g_object_unref()
Since: 3.10
GDBusConnection * e_data_cal_get_connection ();EDataCal *cal
Returns the
Since: 3.8
constgchar * e_data_cal_get_object_path ();EDataCal *cal
Returns the object path at which the Calendar D-Bus interface is exported.
Since: 3.8
void e_data_cal_respond_open (,EDataCal *cal,guint32 opid);GError *error
Notifies listeners of the completion of the open method call.
cal |
A calendar client interface. |
|
opid |
associated operation id |
|
error |
Operation error, if any, automatically freed if passed it. |
Since: 3.2
void e_data_cal_respond_refresh (,EDataCal *cal,guint32 opid);GError *error
Notifies listeners of the completion of the refresh method call.
cal |
A calendar client interface. |
|
opid |
associated operation id |
|
error |
Operation error, if any, automatically freed if passed it. |
Since: 3.2
void e_data_cal_respond_get_object (,EDataCal *cal,guint32 opid,GError *errorconst);gchar *object
Notifies listeners of the completion of the get_object method call.
cal |
A calendar client interface. |
|
opid |
associated operation id |
|
error |
Operation error, if any, automatically freed if passed it. |
|
object |
The object retrieved as an iCalendar string. |
Since: 3.2
void e_data_cal_respond_get_object_list (,EDataCal *cal,guint32 opid,GError *errorconst);GSList *objects
Notifies listeners of the completion of the get_object_list method call.
cal |
A calendar client interface. |
|
opid |
associated operation id |
|
error |
Operation error, if any, automatically freed if passed it. |
|
objects |
List of retrieved objects. |
Since: 3.2
void e_data_cal_respond_get_free_busy (,EDataCal *cal,guint32 opid,GError *errorconst);GSList *freebusy
Notifies listeners of the completion of the get_free_busy method call.
To pass actual free/busy objects to the client asynchronously
use e_data_cal_report_free_busy_data(), but the freebusy
should contain
all the objects being used in e_data_cal_report_free_busy_data().
cal |
A calendar client interface. |
|
opid |
associated operation id |
|
error |
Operation error, if any, automatically freed if passed it. |
|
freebusy |
a |
Since: 3.2
void e_data_cal_respond_create_objects (,EDataCal *cal,guint32 opid,GError *errorconst,GSList *uids);GSList *new_components
Notifies listeners of the completion of the create_objects method call.
cal |
A calendar client interface. |
|
opid |
associated operation id |
|
error |
Operation error, if any, automatically freed if passed it. |
|
uids |
UIDs of the objects created. |
|
new_components |
The newly created |
Since: 3.6
void e_data_cal_respond_modify_objects (,EDataCal *cal,guint32 opid,GError *error,GSList *old_components);GSList *new_components
Notifies listeners of the completion of the modify_objects method call.
cal |
A calendar client interface. |
|
opid |
associated operation id |
|
error |
Operation error, if any, automatically freed if passed it. |
|
old_components |
The old |
|
new_components |
The new |
Since: 3.6
void e_data_cal_respond_remove_objects (,EDataCal *cal,guint32 opid,GError *errorconst,GSList *ids,GSList *old_components);GSList *new_components
Notifies listeners of the completion of the remove_objects method call.
cal |
A calendar client interface. |
|
opid |
associated operation id |
|
error |
Operation error, if any, automatically freed if passed it. |
|
ids |
IDs of the removed objects. |
|
old_components |
The old |
|
new_components |
The new |
Since: 3.6
void e_data_cal_respond_receive_objects (,EDataCal *cal,guint32 opid);GError *error
Notifies listeners of the completion of the receive_objects method call.
cal |
A calendar client interface. |
|
opid |
associated operation id |
|
error |
Operation error, if any, automatically freed if passed it. |
Since: 3.2
void e_data_cal_respond_send_objects (,EDataCal *cal,guint32 opid,GError *errorconst,GSList *usersconst);gchar *calobj
Notifies listeners of the completion of the send_objects method call.
cal |
A calendar client interface. |
|
opid |
associated operation id |
|
error |
Operation error, if any, automatically freed if passed it. |
|
users |
List of users. |
|
calobj |
An iCalendar string representing the object sent. |
Since: 3.2
void e_data_cal_respond_get_attachment_uris (,EDataCal *cal,guint32 opid,GError *errorconst);GSList *attachment_uris
Notifies listeners of the completion of the get_attachment_uris method call.
cal |
A calendar client interface. |
|
opid |
associated operation id |
|
error |
Operation error, if any, automatically freed if passed it. |
|
attachment_uris |
List of retrieved attachment uri's. |
Since: 3.2
void e_data_cal_respond_discard_alarm (,EDataCal *cal,guint32 opid);GError *error
Notifies listeners of the completion of the discard_alarm method call.
cal |
A calendar client interface. |
|
opid |
associated operation id |
|
error |
Operation error, if any, automatically freed if passed it. |
Since: 3.2
void e_data_cal_respond_get_timezone (,EDataCal *cal,guint32 opid,GError *errorconst);gchar *tzobject
Notifies listeners of the completion of the get_timezone method call.
cal |
A calendar client interface. |
|
opid |
associated operation id |
|
error |
Operation error, if any, automatically freed if passed it. |
|
tzobject |
The requested timezone as an iCalendar string. |
Since: 3.2
void e_data_cal_respond_add_timezone (,EDataCal *cal,guint32 opid);GError *error
Notifies listeners of the completion of the add_timezone method call.
cal |
A calendar client interface. |
|
opid |
associated operation id |
|
error |
Operation error, if any, automatically freed if passed it. |
Since: 3.2
void e_data_cal_report_error (,EDataCal *calconst);gchar *message
Emits an error message, thus the clients can be notified about it.
Since: 3.2
void e_data_cal_report_free_busy_data (,EDataCal *calconst);GSList *freebusy
Reports result of a free/busy query on the cal
.
cal |
an |
|
freebusy |
a |
[element-type utf8] |
Since: 3.2
void e_data_cal_report_backend_property_changed (,EDataCal *calconst,gchar *prop_nameconst);gchar *prop_value
Notifies client about certain property value change
Since: 3.2
Response statuses of the calls.
|
call finished successfully |
||
|
the backend is busy |
||
|
the backend is offline |
||
|
the call failed due to permission restrictions |
||
|
the provided range for the call is invalid |
||
|
the requested object could not be found |
||
|
the provided object is invalid |
||
|
the provided object has an ID which already exists |
||
|
failed to authenticate with given credentials |
||
|
authentication credentials are required to connect to the calendar |
||
|
requested field is not supported |
||
|
requested method is not supported |
||
|
requested authentication method is not supported |
||
|
TLS for connection is not available for the calendar |
||
|
requested calendar does not exist |
||
|
provided user is unknown |
||
|
requested data are not available in offline |
||
|
a successful search doesn't contain all responses due to size limit |
||
|
a successful search doesn't contain all responses due to time limit |
||
|
a requested search query is invalid |
||
|
a requested search query had been refused, possibly by the server |
||
|
an ongoing operation cannot be cancelled |
||
|
a generic error happened |
||
|
server version is invalid |
||
|
one of the arguments of the call was invalid |
||
|
the operation is not supported |
||
|
the calendar is not opened |
Since: 3.6