2
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
3
"http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd">
4
<refentry id="libedata-cal-e-cal-backend-util">
6
<refentrytitle role="top_of_page" id="libedata-cal-e-cal-backend-util.top_of_page">e-cal-backend-util</refentrytitle>
7
<manvolnum>3</manvolnum>
13
<refname>e-cal-backend-util</refname>
14
<refpurpose>Utility functions for backends.</refpurpose>
17
<refsynopsisdiv id="libedata-cal-e-cal-backend-util.synopsis" role="synopsis">
18
<title role="synopsis.title">Synopsis</title>
20
<synopsis><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link> <link linkend="e-cal-backend-mail-account-get-default">e_cal_backend_mail_account_get_default</link>
21
(<parameter><link linkend="gchar"><type>gchar</type></link> **address</parameter>,
22
<parameter><link linkend="gchar"><type>gchar</type></link> **name</parameter>);
23
<link linkend="gboolean"><returnvalue>gboolean</returnvalue></link> <link linkend="e-cal-backend-mail-account-is-valid">e_cal_backend_mail_account_is_valid</link> (<parameter><link linkend="gchar"><type>gchar</type></link> *user</parameter>,
24
<parameter><link linkend="gchar"><type>gchar</type></link> **name</parameter>);
25
const <link linkend="gchar"><returnvalue>gchar</returnvalue></link> * <link linkend="e-cal-backend-status-to-string">e_cal_backend_status_to_string</link> (<parameter><link linkend="GNOME-Evolution-Calendar-CallStatus"><type>GNOME_Evolution_Calendar_CallStatus</type></link> status</parameter>);
26
<link linkend="gboolean"><returnvalue>gboolean</returnvalue></link> <link linkend="e-cal-backend-user-declined">e_cal_backend_user_declined</link> (<parameter><link linkend="icalcomponent"><type>icalcomponent</type></link> *icalcomp</parameter>);
30
<refsect1 id="libedata-cal-e-cal-backend-util.description" role="desc">
31
<title role="desc.title">Description</title>
35
<refsect1 id="libedata-cal-e-cal-backend-util.details" role="details">
36
<title role="details.title">Details</title>
37
<refsect2 id="e-cal-backend-mail-account-get-default" role="function">
38
<title>e_cal_backend_mail_account_get_default ()</title>
39
<indexterm zone="e-cal-backend-mail-account-get-default"><primary>e_cal_backend_mail_account_get_default</primary></indexterm>
40
<programlisting><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link> e_cal_backend_mail_account_get_default
41
(<parameter><link linkend="gchar"><type>gchar</type></link> **address</parameter>,
42
<parameter><link linkend="gchar"><type>gchar</type></link> **name</parameter>);</programlisting>
44
Retrieve the default mail account as stored in Evolution configuration.</para>
45
<variablelist role="params">
46
<varlistentry><term><parameter>address</parameter> :</term>
47
<listitem><simpara>Placeholder for default address.
48
</simpara></listitem></varlistentry>
49
<varlistentry><term><parameter>name</parameter> :</term>
50
<listitem><simpara>Placeholder for name.
51
</simpara></listitem></varlistentry>
52
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> TRUE if there is a default account, FALSE otherwise.
53
</simpara></listitem></varlistentry>
54
</variablelist></refsect2>
55
<refsect2 id="e-cal-backend-mail-account-is-valid" role="function">
56
<title>e_cal_backend_mail_account_is_valid ()</title>
57
<indexterm zone="e-cal-backend-mail-account-is-valid"><primary>e_cal_backend_mail_account_is_valid</primary></indexterm>
58
<programlisting><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link> e_cal_backend_mail_account_is_valid (<parameter><link linkend="gchar"><type>gchar</type></link> *user</parameter>,
59
<parameter><link linkend="gchar"><type>gchar</type></link> **name</parameter>);</programlisting>
61
Checks that a mail account is valid, and returns its name.</para>
62
<variablelist role="params">
63
<varlistentry><term><parameter>user</parameter> :</term>
64
<listitem><simpara>User name for the account to check.
65
</simpara></listitem></varlistentry>
66
<varlistentry><term><parameter>name</parameter> :</term>
67
<listitem><simpara>Placeholder for the account name.
68
</simpara></listitem></varlistentry>
69
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> TRUE if the account is valid, FALSE if not.
70
</simpara></listitem></varlistentry>
71
</variablelist></refsect2>
72
<refsect2 id="e-cal-backend-status-to-string" role="function">
73
<title>e_cal_backend_status_to_string ()</title>
74
<indexterm zone="e-cal-backend-status-to-string"><primary>e_cal_backend_status_to_string</primary></indexterm>
75
<programlisting>const <link linkend="gchar"><returnvalue>gchar</returnvalue></link> * e_cal_backend_status_to_string (<parameter><link linkend="GNOME-Evolution-Calendar-CallStatus"><type>GNOME_Evolution_Calendar_CallStatus</type></link> status</parameter>);</programlisting>
77
Converts status code to string.</para>
78
<variablelist role="params">
79
<varlistentry><term><parameter>status</parameter> :</term>
81
</simpara></listitem></varlistentry>
82
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara>
83
</simpara></listitem></varlistentry>
84
</variablelist></refsect2>
85
<refsect2 id="e-cal-backend-user-declined" role="function">
86
<title>e_cal_backend_user_declined ()</title>
87
<indexterm zone="e-cal-backend-user-declined"><primary>e_cal_backend_user_declined</primary></indexterm>
88
<programlisting><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link> e_cal_backend_user_declined (<parameter><link linkend="icalcomponent"><type>icalcomponent</type></link> *icalcomp</parameter>);</programlisting>
89
<variablelist role="params">
90
<varlistentry><term><parameter>icalcomp</parameter> :</term>
92
</simpara></listitem></varlistentry>
93
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara>
94
</simpara></listitem></varlistentry>
95
</variablelist></refsect2>