~ubuntu-branches/ubuntu/raring/evolution-data-server/raring-proposed

« back to all changes in this revision

Viewing changes to docs/reference/libebackend/html/EDataFactory.html

  • Committer: Package Import Robot
  • Author(s): Robert Ancell
  • Date: 2012-11-13 10:12:28 UTC
  • mfrom: (1.1.107)
  • Revision ID: package-import@ubuntu.com-20121113101228-gvueq2vu386p625x
Tags: 3.6.2-0ubuntu1
* New upstream release
* debian/libcamel-1.2-40.symbols::
  - Updated
* debian/patches/dont-abort-in-e_source_registry_new.patch:
  - Applied upstream

Show diffs side-by-side

added added

removed removed

Lines of Context:
46
46
 
47
47
struct              <a class="link" href="EDataFactory.html#EDataFactory-struct" title="struct EDataFactory">EDataFactory</a>;
48
48
<a class="link" href="EBackend.html" title="EBackend"><span class="returnvalue">EBackend</span></a> *          <a class="link" href="EDataFactory.html#e-data-factory-ref-backend" title="e_data_factory_ref_backend ()">e_data_factory_ref_backend</a>          (<em class="parameter"><code><a class="link" href="EDataFactory.html" title="EDataFactory"><span class="type">EDataFactory</span></a> *data_factory</code></em>,
49
 
                                                         <em class="parameter"><code>const <span class="type">gchar</span> *hash_key</code></em>,
50
 
                                                         <em class="parameter"><code><a href="../libedataserver/ESource.html"><span class="type">ESource</span></a> *source</code></em>);
 
49
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *hash_key</code></em>,
 
50
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/libedataserver/ESource.html"><span class="type">ESource</span></a> *source</code></em>);
51
51
<a class="link" href="EBackendFactory.html" title="EBackendFactory"><span class="returnvalue">EBackendFactory</span></a> *   <a class="link" href="EDataFactory.html#e-data-factory-ref-backend-factory" title="e_data_factory_ref_backend_factory ()">e_data_factory_ref_backend_factory</a>  (<em class="parameter"><code><a class="link" href="EDataFactory.html" title="EDataFactory"><span class="type">EDataFactory</span></a> *data_factory</code></em>,
52
 
                                                         <em class="parameter"><code>const <span class="type">gchar</span> *hash_key</code></em>);
 
52
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *hash_key</code></em>);
53
53
</pre>
54
54
</div>
55
55
<div class="refsect1">
56
56
<a name="EDataFactory.object-hierarchy"></a><h2>Object Hierarchy</h2>
57
57
<pre class="synopsis">
58
 
  GObject
 
58
  <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a>
59
59
   +----<a class="link" href="EDBusServer.html" title="EDBusServer">EDBusServer</a>
60
60
         +----EDataFactory
61
61
               +----<a class="link" href="ESourceRegistryServer.html" title="ESourceRegistryServer">ESourceRegistryServer</a>
85
85
<div class="refsect2">
86
86
<a name="e-data-factory-ref-backend"></a><h3>e_data_factory_ref_backend ()</h3>
87
87
<pre class="programlisting"><a class="link" href="EBackend.html" title="EBackend"><span class="returnvalue">EBackend</span></a> *          e_data_factory_ref_backend          (<em class="parameter"><code><a class="link" href="EDataFactory.html" title="EDataFactory"><span class="type">EDataFactory</span></a> *data_factory</code></em>,
88
 
                                                         <em class="parameter"><code>const <span class="type">gchar</span> *hash_key</code></em>,
89
 
                                                         <em class="parameter"><code><a href="../libedataserver/ESource.html"><span class="type">ESource</span></a> *source</code></em>);</pre>
 
88
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *hash_key</code></em>,
 
89
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/libedataserver/ESource.html"><span class="type">ESource</span></a> *source</code></em>);</pre>
90
90
<p>
91
 
Returns either a newly-created or existing <a class="link" href="EBackend.html" title="EBackend"><span class="type">EBackend</span></a> for <a href="../libedataserver/ESource.html"><span class="type">ESource</span></a>.
 
91
Returns either a newly-created or existing <a class="link" href="EBackend.html" title="EBackend"><span class="type">EBackend</span></a> for <a href="/usr/share/gtk-doc/html/libedataserver/ESource.html"><span class="type">ESource</span></a>.
92
92
The returned <a class="link" href="EBackend.html" title="EBackend"><span class="type">EBackend</span></a> is referenced for thread-safety and must be
93
 
unreferenced with <code class="function">g_object_unref()</code> when finished with it.
 
93
unreferenced with <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a> when finished with it.
94
94
</p>
95
95
<p>
96
96
The <em class="parameter"><code>data_factory</code></em> retains a weak reference to <em class="parameter"><code>backend</code></em> so it can return
100
100
and <em class="parameter"><code>source</code></em> are requested.
101
101
</p>
102
102
<p>
103
 
If no suitable <a class="link" href="EBackendFactory.html" title="EBackendFactory"><span class="type">EBackendFactory</span></a> exists, the function returns <code class="literal">NULL</code>.
 
103
If no suitable <a class="link" href="EBackendFactory.html" title="EBackendFactory"><span class="type">EBackendFactory</span></a> exists, the function returns <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.
104
104
</p>
105
105
<div class="variablelist"><table border="0">
106
106
<col align="left" valign="top">
117
117
</tr>
118
118
<tr>
119
119
<td><p><span class="term"><em class="parameter"><code>source</code></em> :</span></p></td>
120
 
<td>an <a href="../libedataserver/ESource.html"><span class="type">ESource</span></a>
 
120
<td>an <a href="/usr/share/gtk-doc/html/libedataserver/ESource.html"><span class="type">ESource</span></a>
121
121
</td>
122
122
</tr>
123
123
<tr>
124
124
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
125
 
<td>an <a class="link" href="EBackend.html" title="EBackend"><span class="type">EBackend</span></a> for <em class="parameter"><code>source</code></em>, or <code class="literal">NULL</code>
 
125
<td>an <a class="link" href="EBackend.html" title="EBackend"><span class="type">EBackend</span></a> for <em class="parameter"><code>source</code></em>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
126
126
</td>
127
127
</tr>
128
128
</tbody>
133
133
<div class="refsect2">
134
134
<a name="e-data-factory-ref-backend-factory"></a><h3>e_data_factory_ref_backend_factory ()</h3>
135
135
<pre class="programlisting"><a class="link" href="EBackendFactory.html" title="EBackendFactory"><span class="returnvalue">EBackendFactory</span></a> *   e_data_factory_ref_backend_factory  (<em class="parameter"><code><a class="link" href="EDataFactory.html" title="EDataFactory"><span class="type">EDataFactory</span></a> *data_factory</code></em>,
136
 
                                                         <em class="parameter"><code>const <span class="type">gchar</span> *hash_key</code></em>);</pre>
 
136
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *hash_key</code></em>);</pre>
137
137
<p>
138
 
Returns the <a class="link" href="EBackendFactory.html" title="EBackendFactory"><span class="type">EBackendFactory</span></a> for <em class="parameter"><code>hash_key</code></em>, or <code class="literal">NULL</code> if no such factory
 
138
Returns the <a class="link" href="EBackendFactory.html" title="EBackendFactory"><span class="type">EBackendFactory</span></a> for <em class="parameter"><code>hash_key</code></em>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if no such factory
139
139
is registered.
140
140
</p>
141
141
<p>
142
142
The returned <a class="link" href="EBackendFactory.html" title="EBackendFactory"><span class="type">EBackendFactory</span></a> is referenced for thread-safety.
143
 
Unreference the <a class="link" href="EBackendFactory.html" title="EBackendFactory"><span class="type">EBackendFactory</span></a> with <code class="function">g_object_unref()</code> when finished
 
143
Unreference the <a class="link" href="EBackendFactory.html" title="EBackendFactory"><span class="type">EBackendFactory</span></a> with <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a> when finished
144
144
with it.
145
145
</p>
146
146
<div class="variablelist"><table border="0">
158
158
</tr>
159
159
<tr>
160
160
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
161
 
<td>the <a class="link" href="EBackendFactory.html" title="EBackendFactory"><span class="type">EBackendFactory</span></a> for <em class="parameter"><code>hash_key</code></em>, or <code class="literal">NULL</code>
 
161
<td>the <a class="link" href="EBackendFactory.html" title="EBackendFactory"><span class="type">EBackendFactory</span></a> for <em class="parameter"><code>hash_key</code></em>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
162
162
</td>
163
163
</tr>
164
164
</tbody>