1
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
4
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
5
<title>EDataBook</title>
6
<meta name="generator" content="DocBook XSL Stylesheets V1.69.1">
7
<link rel="start" href="index.html" title="Evolution API Reference: libedata-book, the Addressbook backend library">
8
<link rel="up" href="ch01.html" title="Evolution API Reference: libedata-book, the Addressbook backend library">
9
<link rel="prev" href="EBookBackendSync.html" title="EBookBackendSync">
10
<link rel="next" href="libedata-book-EDataBookFactory.html" title="EDataBookFactory">
11
<meta name="generator" content="GTK-Doc V1.7 (XML mode)">
12
<link rel="stylesheet" href="style.css" type="text/css">
13
<link rel="chapter" href="ch01.html" title="Evolution API Reference: libedata-book, the Addressbook backend library">
14
<link rel="index" href="ix01.html" title="Index">
16
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
17
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
19
<td><a accesskey="p" href="EBookBackendSync.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
20
<td><a accesskey="u" href="ch01.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
21
<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
22
<th width="100%" align="center">Evolution API Reference: libedata-book, the Addressbook backend library</th>
23
<td><a accesskey="n" href="libedata-book-EDataBookFactory.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
25
<tr><td colspan="5" class="shortcuts"><nobr><a href="#id2540412" class="shortcut">Top</a>
27
<a href="#id2538310" class="shortcut">Description</a>
29
<a href="#id2538280" class="shortcut">Object Hierarchy</a></nobr></td></tr>
31
<div class="refentry" lang="en">
32
<a name="EDataBook"></a><div class="titlepage"></div>
33
<div class="refnamediv"><table width="100%"><tr>
36
<a name="id2540412"></a><span class="refentrytitle">EDataBook</span>
38
<p>EDataBook — </p>
40
<td valign="top" align="right"></td>
42
<div class="refsynopsisdiv">
44
<pre class="synopsis">
48
struct <a href="EDataBook.html#EDataBook-struct">EDataBook</a>;
49
<a href="EDataBook.html" title="EDataBook">EDataBook</a>* <a href="EDataBook.html#e-data-book-new">e_data_book_new</a> (<a href="EBookBackend.html" title="EBookBackend">EBookBackend</a> *backend,
51
GNOME_Evolution_Addressbook_BookListener listener);
52
GNOME_Evolution_Addressbook_BookListener <a href="EDataBook.html#e-data-book-get-listener">e_data_book_get_listener</a>
53
(<a href="EDataBook.html" title="EDataBook">EDataBook</a> *book);
54
<a href="EBookBackend.html" title="EBookBackend">EBookBackend</a>* <a href="EDataBook.html#e-data-book-get-backend">e_data_book_get_backend</a> (<a href="EDataBook.html" title="EDataBook">EDataBook</a> *book);
55
ESource* <a href="EDataBook.html#e-data-book-get-source">e_data_book_get_source</a> (<a href="EDataBook.html" title="EDataBook">EDataBook</a> *book);
56
void <a href="EDataBook.html#e-data-book-respond-open">e_data_book_respond_open</a> (<a href="EDataBook.html" title="EDataBook">EDataBook</a> *book,
58
href="/opt/gnome/share/gtk-doc/html/glib/glib-Basic-Types.html#guint32"
60
GNOME_Evolution_Addressbook_CallStatus status);
61
void <a href="EDataBook.html#e-data-book-respond-remove">e_data_book_respond_remove</a> (<a href="EDataBook.html" title="EDataBook">EDataBook</a> *book,
63
href="/opt/gnome/share/gtk-doc/html/glib/glib-Basic-Types.html#guint32"
65
GNOME_Evolution_Addressbook_CallStatus status);
66
void <a href="EDataBook.html#e-data-book-respond-create">e_data_book_respond_create</a> (<a href="EDataBook.html" title="EDataBook">EDataBook</a> *book,
68
href="/opt/gnome/share/gtk-doc/html/glib/glib-Basic-Types.html#guint32"
70
GNOME_Evolution_Addressbook_CallStatus status,
72
href="/opt/gnome/share/gtk-doc/html/libebook/EContact.html"
73
>EContact</a> *contact);
74
void <a href="EDataBook.html#e-data-book-respond-remove-contacts">e_data_book_respond_remove_contacts</a>
75
(<a href="EDataBook.html" title="EDataBook">EDataBook</a> *book,
77
href="/opt/gnome/share/gtk-doc/html/glib/glib-Basic-Types.html#guint32"
79
GNOME_Evolution_Addressbook_CallStatus status,
81
href="/opt/gnome/share/gtk-doc/html/glib/glib-Doubly-Linked-Lists.html#GList"
83
void <a href="EDataBook.html#e-data-book-respond-modify">e_data_book_respond_modify</a> (<a href="EDataBook.html" title="EDataBook">EDataBook</a> *book,
85
href="/opt/gnome/share/gtk-doc/html/glib/glib-Basic-Types.html#guint32"
87
GNOME_Evolution_Addressbook_CallStatus status,
89
href="/opt/gnome/share/gtk-doc/html/libebook/EContact.html"
90
>EContact</a> *contact);
91
void <a href="EDataBook.html#e-data-book-respond-authenticate-user">e_data_book_respond_authenticate_user</a>
92
(<a href="EDataBook.html" title="EDataBook">EDataBook</a> *book,
94
href="/opt/gnome/share/gtk-doc/html/glib/glib-Basic-Types.html#guint32"
96
GNOME_Evolution_Addressbook_CallStatus status);
97
void <a href="EDataBook.html#e-data-book-respond-get-supported-fields">e_data_book_respond_get_supported_fields</a>
98
(<a href="EDataBook.html" title="EDataBook">EDataBook</a> *book,
100
href="/opt/gnome/share/gtk-doc/html/glib/glib-Basic-Types.html#guint32"
102
GNOME_Evolution_Addressbook_CallStatus status,
104
href="/opt/gnome/share/gtk-doc/html/glib/glib-Doubly-Linked-Lists.html#GList"
106
void <a href="EDataBook.html#e-data-book-respond-get-required-fields">e_data_book_respond_get_required_fields</a>
107
(<a href="EDataBook.html" title="EDataBook">EDataBook</a> *book,
109
href="/opt/gnome/share/gtk-doc/html/glib/glib-Basic-Types.html#guint32"
111
GNOME_Evolution_Addressbook_CallStatus status,
113
href="/opt/gnome/share/gtk-doc/html/glib/glib-Doubly-Linked-Lists.html#GList"
115
void <a href="EDataBook.html#e-data-book-respond-get-supported-auth-methods">e_data_book_respond_get_supported_auth_methods</a>
116
(<a href="EDataBook.html" title="EDataBook">EDataBook</a> *book,
118
href="/opt/gnome/share/gtk-doc/html/glib/glib-Basic-Types.html#guint32"
120
GNOME_Evolution_Addressbook_CallStatus status,
122
href="/opt/gnome/share/gtk-doc/html/glib/glib-Doubly-Linked-Lists.html#GList"
124
void <a href="EDataBook.html#e-data-book-respond-get-book-view">e_data_book_respond_get_book_view</a>
125
(<a href="EDataBook.html" title="EDataBook">EDataBook</a> *book,
127
href="/opt/gnome/share/gtk-doc/html/glib/glib-Basic-Types.html#guint32"
129
GNOME_Evolution_Addressbook_CallStatus status,
130
<a href="EDataBookView.html" title="EDataBookView">EDataBookView</a> *book_view);
131
void <a href="EDataBook.html#e-data-book-respond-get-contact">e_data_book_respond_get_contact</a> (<a href="EDataBook.html" title="EDataBook">EDataBook</a> *book,
133
href="/opt/gnome/share/gtk-doc/html/glib/glib-Basic-Types.html#guint32"
135
GNOME_Evolution_Addressbook_CallStatus status,
137
void <a href="EDataBook.html#e-data-book-respond-get-contact-list">e_data_book_respond_get_contact_list</a>
138
(<a href="EDataBook.html" title="EDataBook">EDataBook</a> *book,
140
href="/opt/gnome/share/gtk-doc/html/glib/glib-Basic-Types.html#guint32"
142
GNOME_Evolution_Addressbook_CallStatus status,
144
href="/opt/gnome/share/gtk-doc/html/glib/glib-Doubly-Linked-Lists.html#GList"
146
void <a href="EDataBook.html#e-data-book-respond-get-changes">e_data_book_respond_get_changes</a> (<a href="EDataBook.html" title="EDataBook">EDataBook</a> *book,
148
href="/opt/gnome/share/gtk-doc/html/glib/glib-Basic-Types.html#guint32"
150
GNOME_Evolution_Addressbook_CallStatus status,
152
href="/opt/gnome/share/gtk-doc/html/glib/glib-Doubly-Linked-Lists.html#GList"
153
>GList</a> *changes);
154
void <a href="EDataBook.html#e-data-book-report-writable">e_data_book_report_writable</a> (<a href="EDataBook.html" title="EDataBook">EDataBook</a> *book,
156
href="/opt/gnome/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
157
>gboolean</a> writable);
158
void <a href="EDataBook.html#e-data-book-report-connection-status">e_data_book_report_connection_status</a>
159
(<a href="EDataBook.html" title="EDataBook">EDataBook</a> *book,
161
href="/opt/gnome/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
162
>gboolean</a> is_online);
163
void <a href="EDataBook.html#e-data-book-report-auth-required">e_data_book_report_auth_required</a>
164
(<a href="EDataBook.html" title="EDataBook">EDataBook</a> *book);
169
<div class="refsect1" lang="en">
170
<a name="id2538280"></a><h2>Object Hierarchy</h2>
171
<pre class="synopsis">
174
href="/opt/gnome/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"
177
href="/opt/gnome/share/gtk-doc/html/libbonobo/libbonobo-bonobo-object.html#BonoboObject"
182
<div class="refsect1" lang="en">
183
<a name="id2538310"></a><h2>Description</h2>
188
<div class="refsect1" lang="en">
189
<a name="id2538326"></a><h2>Details</h2>
190
<div class="refsect2" lang="en">
191
<a name="id2538337"></a><h3>
192
<a name="EDataBook-struct"></a>struct EDataBook</h3>
193
<a class="indexterm" name="id2538349"></a><pre class="programlisting">struct EDataBook;</pre>
199
<div class="refsect2" lang="en">
200
<a name="id2538365"></a><h3>
201
<a name="e-data-book-new"></a>e_data_book_new ()</h3>
202
<a class="indexterm" name="id2538377"></a><pre class="programlisting"><a href="EDataBook.html" title="EDataBook">EDataBook</a>* e_data_book_new (<a href="EBookBackend.html" title="EBookBackend">EBookBackend</a> *backend,
204
GNOME_Evolution_Addressbook_BookListener listener);</pre>
206
Create a new <a href="EDataBook.html" title="EDataBook"><span class="type">EDataBook</span></a> using <em class="parameter"><code>backend</code></em> for storage, <em class="parameter"><code>source</code></em> as the
207
storage location and <em class="parameter"><code>listener</code></em> for reporting status.</p>
211
<div class="variablelist"><table border="0">
212
<col align="left" valign="top">
215
<td><span class="term"><em class="parameter"><code>backend</code></em> :</span></td>
216
<td> an <a href="EBookBackend.html" title="EBookBackend"><span class="type">EBookBackend</span></a>
220
<td><span class="term"><em class="parameter"><code>source</code></em> :</span></td>
221
<td> an <span class="type">ESource</span>
225
<td><span class="term"><em class="parameter"><code>listener</code></em> :</span></td>
226
<td> a <span class="type">GNOME_Evolution_Addressbook_BookListener</span> CORBA object
230
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
231
<td> A new <a href="EDataBook.html" title="EDataBook"><span class="type">EDataBook</span></a>.
238
<div class="refsect2" lang="en">
239
<a name="id2590685"></a><h3>
240
<a name="e-data-book-get-listener"></a>e_data_book_get_listener ()</h3>
241
<a class="indexterm" name="id2590696"></a><pre class="programlisting">GNOME_Evolution_Addressbook_BookListener e_data_book_get_listener
242
(<a href="EDataBook.html" title="EDataBook">EDataBook</a> *book);</pre>
244
Gets the CORBA listener associated with <em class="parameter"><code>book</code></em>.</p>
248
<div class="variablelist"><table border="0">
249
<col align="left" valign="top">
252
<td><span class="term"><em class="parameter"><code>book</code></em> :</span></td>
253
<td> an <a href="EDataBook.html" title="EDataBook"><span class="type">EDataBook</span></a>
257
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
258
<td> A <span class="type">GNOME_Evolution_Addressbook_BookListener</span>.
265
<div class="refsect2" lang="en">
266
<a name="id2590771"></a><h3>
267
<a name="e-data-book-get-backend"></a>e_data_book_get_backend ()</h3>
268
<a class="indexterm" name="id2590782"></a><pre class="programlisting"><a href="EBookBackend.html" title="EBookBackend">EBookBackend</a>* e_data_book_get_backend (<a href="EDataBook.html" title="EDataBook">EDataBook</a> *book);</pre>
270
Gets the <a href="EBookBackend.html" title="EBookBackend"><span class="type">EBookBackend</span></a> being used to store data for <em class="parameter"><code>book</code></em>.</p>
274
<div class="variablelist"><table border="0">
275
<col align="left" valign="top">
278
<td><span class="term"><em class="parameter"><code>book</code></em> :</span></td>
279
<td> an <a href="EDataBook.html" title="EDataBook"><span class="type">EDataBook</span></a>
283
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
284
<td> The <a href="EBookBackend.html" title="EBookBackend"><span class="type">EBookBackend</span></a> being used.
291
<div class="refsect2" lang="en">
292
<a name="id2590871"></a><h3>
293
<a name="e-data-book-get-source"></a>e_data_book_get_source ()</h3>
294
<a class="indexterm" name="id2590882"></a><pre class="programlisting">ESource* e_data_book_get_source (<a href="EDataBook.html" title="EDataBook">EDataBook</a> *book);</pre>
296
Gets the <span class="type">ESource</span> associated with <em class="parameter"><code>book</code></em>.</p>
300
<div class="variablelist"><table border="0">
301
<col align="left" valign="top">
304
<td><span class="term"><em class="parameter"><code>book</code></em> :</span></td>
305
<td> an <a href="EDataBook.html" title="EDataBook"><span class="type">EDataBook</span></a>
309
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
310
<td> An <span class="type">ESource</span>.
317
<div class="refsect2" lang="en">
318
<a name="id2590969"></a><h3>
319
<a name="e-data-book-respond-open"></a>e_data_book_respond_open ()</h3>
320
<a class="indexterm" name="id2590980"></a><pre class="programlisting">void e_data_book_respond_open (<a href="EDataBook.html" title="EDataBook">EDataBook</a> *book,
322
href="/opt/gnome/share/gtk-doc/html/glib/glib-Basic-Types.html#guint32"
324
GNOME_Evolution_Addressbook_CallStatus status);</pre>
326
Respond to an 'open' request specified by <em class="parameter"><code>opid</code></em> on <em class="parameter"><code>book</code></em>,
327
indicating <em class="parameter"><code>status</code></em> as the outcome.</p>
331
<div class="variablelist"><table border="0">
332
<col align="left" valign="top">
335
<td><span class="term"><em class="parameter"><code>book</code></em> :</span></td>
336
<td> an <a href="EDataBook.html" title="EDataBook"><span class="type">EDataBook</span></a>
340
<td><span class="term"><em class="parameter"><code>opid</code></em> :</span></td>
341
<td> the operation ID that generated the response
345
<td><span class="term"><em class="parameter"><code>status</code></em> :</span></td>
346
<td> the outcome of the operation
353
<div class="refsect2" lang="en">
354
<a name="id2591100"></a><h3>
355
<a name="e-data-book-respond-remove"></a>e_data_book_respond_remove ()</h3>
356
<a class="indexterm" name="id2591112"></a><pre class="programlisting">void e_data_book_respond_remove (<a href="EDataBook.html" title="EDataBook">EDataBook</a> *book,
358
href="/opt/gnome/share/gtk-doc/html/glib/glib-Basic-Types.html#guint32"
360
GNOME_Evolution_Addressbook_CallStatus status);</pre>
362
Respond to a 'remove' request to remove all of <em class="parameter"><code>book</code></em>'s data,
363
specified by <em class="parameter"><code>opid</code></em>, indicating <em class="parameter"><code>status</code></em> as the outcome.</p>
367
<div class="variablelist"><table border="0">
368
<col align="left" valign="top">
371
<td><span class="term"><em class="parameter"><code>book</code></em> :</span></td>
372
<td> an <a href="EDataBook.html" title="EDataBook"><span class="type">EDataBook</span></a>
376
<td><span class="term"><em class="parameter"><code>opid</code></em> :</span></td>
377
<td> the operation ID that generated the response
381
<td><span class="term"><em class="parameter"><code>status</code></em> :</span></td>
382
<td> the outcome of the operation
389
<div class="refsect2" lang="en">
390
<a name="id2591231"></a><h3>
391
<a name="e-data-book-respond-create"></a>e_data_book_respond_create ()</h3>
392
<a class="indexterm" name="id2591243"></a><pre class="programlisting">void e_data_book_respond_create (<a href="EDataBook.html" title="EDataBook">EDataBook</a> *book,
394
href="/opt/gnome/share/gtk-doc/html/glib/glib-Basic-Types.html#guint32"
396
GNOME_Evolution_Addressbook_CallStatus status,
398
href="/opt/gnome/share/gtk-doc/html/libebook/EContact.html"
399
>EContact</a> *contact);</pre>
401
Respond to a 'create' request specified by <em class="parameter"><code>opid</code></em> on <em class="parameter"><code>book</code></em>,
402
indicating <em class="parameter"><code>status</code></em> as the outcome.</p>
406
<div class="variablelist"><table border="0">
407
<col align="left" valign="top">
410
<td><span class="term"><em class="parameter"><code>book</code></em> :</span></td>
411
<td> an <a href="EDataBook.html" title="EDataBook"><span class="type">EDataBook</span></a>
415
<td><span class="term"><em class="parameter"><code>opid</code></em> :</span></td>
416
<td> the operation ID that generated the response
420
<td><span class="term"><em class="parameter"><code>status</code></em> :</span></td>
421
<td> the outcome of the operation
425
<td><span class="term"><em class="parameter"><code>contact</code></em> :</span></td>
426
<td> the contact created, or <a
427
href="/opt/gnome/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
428
><code class="literal">NULL</code></a>
435
<div class="refsect2" lang="en">
436
<a name="id2591392"></a><h3>
437
<a name="e-data-book-respond-remove-contacts"></a>e_data_book_respond_remove_contacts ()</h3>
438
<a class="indexterm" name="id2591406"></a><pre class="programlisting">void e_data_book_respond_remove_contacts
439
(<a href="EDataBook.html" title="EDataBook">EDataBook</a> *book,
441
href="/opt/gnome/share/gtk-doc/html/glib/glib-Basic-Types.html#guint32"
443
GNOME_Evolution_Addressbook_CallStatus status,
445
href="/opt/gnome/share/gtk-doc/html/glib/glib-Doubly-Linked-Lists.html#GList"
446
>GList</a> *ids);</pre>
448
Respond to a 'remove contacts' request specified by <em class="parameter"><code>opid</code></em> on <em class="parameter"><code>book</code></em>,
449
indicating <em class="parameter"><code>status</code></em> as the outcome.</p>
453
<div class="variablelist"><table border="0">
454
<col align="left" valign="top">
457
<td><span class="term"><em class="parameter"><code>book</code></em> :</span></td>
458
<td> an <a href="EDataBook.html" title="EDataBook"><span class="type">EDataBook</span></a>
462
<td><span class="term"><em class="parameter"><code>opid</code></em> :</span></td>
463
<td> the operation ID that generated the response
467
<td><span class="term"><em class="parameter"><code>status</code></em> :</span></td>
468
<td> the outcome of the operation
472
<td><span class="term"><em class="parameter"><code>ids</code></em> :</span></td>
473
<td> a list of contact IDs removed
480
<div class="refsect2" lang="en">
481
<a name="id2591548"></a><h3>
482
<a name="e-data-book-respond-modify"></a>e_data_book_respond_modify ()</h3>
483
<a class="indexterm" name="id2591560"></a><pre class="programlisting">void e_data_book_respond_modify (<a href="EDataBook.html" title="EDataBook">EDataBook</a> *book,
485
href="/opt/gnome/share/gtk-doc/html/glib/glib-Basic-Types.html#guint32"
487
GNOME_Evolution_Addressbook_CallStatus status,
489
href="/opt/gnome/share/gtk-doc/html/libebook/EContact.html"
490
>EContact</a> *contact);</pre>
492
Respond to a 'modify' request specified by <em class="parameter"><code>opid</code></em> on <em class="parameter"><code>book</code></em>,
493
indicating <em class="parameter"><code>status</code></em> as the outcome.</p>
497
<div class="variablelist"><table border="0">
498
<col align="left" valign="top">
501
<td><span class="term"><em class="parameter"><code>book</code></em> :</span></td>
502
<td> an <a href="EDataBook.html" title="EDataBook"><span class="type">EDataBook</span></a>
506
<td><span class="term"><em class="parameter"><code>opid</code></em> :</span></td>
507
<td> the operation ID that generated the response
511
<td><span class="term"><em class="parameter"><code>status</code></em> :</span></td>
512
<td> the outcome of the operation
516
<td><span class="term"><em class="parameter"><code>contact</code></em> :</span></td>
518
href="/opt/gnome/share/gtk-doc/html/libebook/EContact.html"
519
><span class="type">EContact</span></a>
526
<div class="refsect2" lang="en">
527
<a name="id2591708"></a><h3>
528
<a name="e-data-book-respond-authenticate-user"></a>e_data_book_respond_authenticate_user ()</h3>
529
<a class="indexterm" name="id2591721"></a><pre class="programlisting">void e_data_book_respond_authenticate_user
530
(<a href="EDataBook.html" title="EDataBook">EDataBook</a> *book,
532
href="/opt/gnome/share/gtk-doc/html/glib/glib-Basic-Types.html#guint32"
534
GNOME_Evolution_Addressbook_CallStatus status);</pre>
536
Respond to an 'authenticate' request specified by <em class="parameter"><code>opid</code></em> on <em class="parameter"><code>book</code></em>,
537
indicating <em class="parameter"><code>status</code></em> as the outcome.</p>
541
<div class="variablelist"><table border="0">
542
<col align="left" valign="top">
545
<td><span class="term"><em class="parameter"><code>book</code></em> :</span></td>
546
<td> an <a href="EDataBook.html" title="EDataBook"><span class="type">EDataBook</span></a>
550
<td><span class="term"><em class="parameter"><code>opid</code></em> :</span></td>
551
<td> the operation ID that generated the response
555
<td><span class="term"><em class="parameter"><code>status</code></em> :</span></td>
556
<td> the outcome of the operation
563
<div class="refsect2" lang="en">
564
<a name="id2591842"></a><h3>
565
<a name="e-data-book-respond-get-supported-fields"></a>e_data_book_respond_get_supported_fields ()</h3>
566
<a class="indexterm" name="id2591856"></a><pre class="programlisting">void e_data_book_respond_get_supported_fields
567
(<a href="EDataBook.html" title="EDataBook">EDataBook</a> *book,
569
href="/opt/gnome/share/gtk-doc/html/glib/glib-Basic-Types.html#guint32"
571
GNOME_Evolution_Addressbook_CallStatus status,
573
href="/opt/gnome/share/gtk-doc/html/glib/glib-Doubly-Linked-Lists.html#GList"
574
>GList</a> *fields);</pre>
576
Respond to a 'get supported fields' request specified by <em class="parameter"><code>opid</code></em> on <em class="parameter"><code>book</code></em>,
577
indicating <em class="parameter"><code>status</code></em> as the outcome.</p>
581
<div class="variablelist"><table border="0">
582
<col align="left" valign="top">
585
<td><span class="term"><em class="parameter"><code>book</code></em> :</span></td>
586
<td> an <a href="EDataBook.html" title="EDataBook"><span class="type">EDataBook</span></a>
590
<td><span class="term"><em class="parameter"><code>opid</code></em> :</span></td>
591
<td> the operation ID that generated the response
595
<td><span class="term"><em class="parameter"><code>status</code></em> :</span></td>
596
<td> the outcome of the operation
600
<td><span class="term"><em class="parameter"><code>fields</code></em> :</span></td>
601
<td> a list of supported field names
608
<div class="refsect2" lang="en">
609
<a name="id2591999"></a><h3>
610
<a name="e-data-book-respond-get-required-fields"></a>e_data_book_respond_get_required_fields ()</h3>
611
<a class="indexterm" name="id2592012"></a><pre class="programlisting">void e_data_book_respond_get_required_fields
612
(<a href="EDataBook.html" title="EDataBook">EDataBook</a> *book,
614
href="/opt/gnome/share/gtk-doc/html/glib/glib-Basic-Types.html#guint32"
616
GNOME_Evolution_Addressbook_CallStatus status,
618
href="/opt/gnome/share/gtk-doc/html/glib/glib-Doubly-Linked-Lists.html#GList"
619
>GList</a> *fields);</pre>
621
Respond to a 'get required fields' request specified by <em class="parameter"><code>opid</code></em> on <em class="parameter"><code>book</code></em>,
622
indicating <em class="parameter"><code>status</code></em> as the outcome.</p>
626
<div class="variablelist"><table border="0">
627
<col align="left" valign="top">
630
<td><span class="term"><em class="parameter"><code>book</code></em> :</span></td>
631
<td> an <a href="EDataBook.html" title="EDataBook"><span class="type">EDataBook</span></a>
635
<td><span class="term"><em class="parameter"><code>opid</code></em> :</span></td>
636
<td> the operation ID that generated the response
640
<td><span class="term"><em class="parameter"><code>status</code></em> :</span></td>
641
<td> the outcome of the operation
645
<td><span class="term"><em class="parameter"><code>fields</code></em> :</span></td>
646
<td> a list of required field names
653
<div class="refsect2" lang="en">
654
<a name="id2592155"></a><h3>
655
<a name="e-data-book-respond-get-supported-auth-methods"></a>e_data_book_respond_get_supported_auth_methods ()</h3>
656
<a class="indexterm" name="id2592169"></a><pre class="programlisting">void e_data_book_respond_get_supported_auth_methods
657
(<a href="EDataBook.html" title="EDataBook">EDataBook</a> *book,
659
href="/opt/gnome/share/gtk-doc/html/glib/glib-Basic-Types.html#guint32"
661
GNOME_Evolution_Addressbook_CallStatus status,
663
href="/opt/gnome/share/gtk-doc/html/glib/glib-Doubly-Linked-Lists.html#GList"
664
>GList</a> *fields);</pre>
666
Respond to a 'get supported auth methods' request specified by <em class="parameter"><code>opid</code></em> on <em class="parameter"><code>book</code></em>,
667
indicating <em class="parameter"><code>status</code></em> as the outcome.</p>
671
<div class="variablelist"><table border="0">
672
<col align="left" valign="top">
675
<td><span class="term"><em class="parameter"><code>book</code></em> :</span></td>
676
<td> an <a href="EDataBook.html" title="EDataBook"><span class="type">EDataBook</span></a>
680
<td><span class="term"><em class="parameter"><code>opid</code></em> :</span></td>
681
<td> the operation ID that generated the response
685
<td><span class="term"><em class="parameter"><code>status</code></em> :</span></td>
686
<td> the outcome of the operation
690
<td><span class="term"><em class="parameter"><code>fields</code></em> :</span></td>
700
<div class="refsect2" lang="en">
701
<a name="id2592311"></a><h3>
702
<a name="e-data-book-respond-get-book-view"></a>e_data_book_respond_get_book_view ()</h3>
703
<a class="indexterm" name="id2592325"></a><pre class="programlisting">void e_data_book_respond_get_book_view
704
(<a href="EDataBook.html" title="EDataBook">EDataBook</a> *book,
706
href="/opt/gnome/share/gtk-doc/html/glib/glib-Basic-Types.html#guint32"
708
GNOME_Evolution_Addressbook_CallStatus status,
709
<a href="EDataBookView.html" title="EDataBookView">EDataBookView</a> *book_view);</pre>
711
Respond to a 'get book view' request specified by <em class="parameter"><code>opid</code></em> on <em class="parameter"><code>book</code></em>,
712
indicating <em class="parameter"><code>status</code></em> as the outcome.</p>
716
<div class="variablelist"><table border="0">
717
<col align="left" valign="top">
720
<td><span class="term"><em class="parameter"><code>book</code></em> :</span></td>
721
<td> an <a href="EDataBook.html" title="EDataBook"><span class="type">EDataBook</span></a>
725
<td><span class="term"><em class="parameter"><code>opid</code></em> :</span></td>
726
<td> the operation ID that generated the response
730
<td><span class="term"><em class="parameter"><code>status</code></em> :</span></td>
731
<td> the outcome of the operation
735
<td><span class="term"><em class="parameter"><code>book_view</code></em> :</span></td>
736
<td> the <a href="EDataBookView.html" title="EDataBookView"><span class="type">EDataBookView</span></a> created
743
<div class="refsect2" lang="en">
744
<a name="id2592474"></a><h3>
745
<a name="e-data-book-respond-get-contact"></a>e_data_book_respond_get_contact ()</h3>
746
<a class="indexterm" name="id2592487"></a><pre class="programlisting">void e_data_book_respond_get_contact (<a href="EDataBook.html" title="EDataBook">EDataBook</a> *book,
748
href="/opt/gnome/share/gtk-doc/html/glib/glib-Basic-Types.html#guint32"
750
GNOME_Evolution_Addressbook_CallStatus status,
753
Respond to a 'get contact' request specified by <em class="parameter"><code>opid</code></em> on <em class="parameter"><code>book</code></em>,
754
indicating <em class="parameter"><code>status</code></em> as the outcome.</p>
758
<div class="variablelist"><table border="0">
759
<col align="left" valign="top">
762
<td><span class="term"><em class="parameter"><code>book</code></em> :</span></td>
763
<td> an <a href="EDataBook.html" title="EDataBook"><span class="type">EDataBook</span></a>
767
<td><span class="term"><em class="parameter"><code>opid</code></em> :</span></td>
768
<td> the operation ID that generated the response
772
<td><span class="term"><em class="parameter"><code>status</code></em> :</span></td>
773
<td> the outcome of the operation
777
<td><span class="term"><em class="parameter"><code>vcard</code></em> :</span></td>
778
<td> the found VCard, or <a
779
href="/opt/gnome/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
780
><code class="literal">NULL</code></a>
787
<div class="refsect2" lang="en">
788
<a name="id2537451"></a><h3>
789
<a name="e-data-book-respond-get-contact-list"></a>e_data_book_respond_get_contact_list ()</h3>
790
<a class="indexterm" name="id2592632"></a><pre class="programlisting">void e_data_book_respond_get_contact_list
791
(<a href="EDataBook.html" title="EDataBook">EDataBook</a> *book,
793
href="/opt/gnome/share/gtk-doc/html/glib/glib-Basic-Types.html#guint32"
795
GNOME_Evolution_Addressbook_CallStatus status,
797
href="/opt/gnome/share/gtk-doc/html/glib/glib-Doubly-Linked-Lists.html#GList"
798
>GList</a> *cards);</pre>
800
Respond to a 'get contact list' request specified by <em class="parameter"><code>opid</code></em> on <em class="parameter"><code>book</code></em>,
801
indicating <em class="parameter"><code>status</code></em> as the outcome.</p>
805
<div class="variablelist"><table border="0">
806
<col align="left" valign="top">
809
<td><span class="term"><em class="parameter"><code>book</code></em> :</span></td>
810
<td> an <a href="EDataBook.html" title="EDataBook"><span class="type">EDataBook</span></a>
814
<td><span class="term"><em class="parameter"><code>opid</code></em> :</span></td>
815
<td> the operation ID that generated the response
819
<td><span class="term"><em class="parameter"><code>status</code></em> :</span></td>
820
<td> the outcome of the operation
824
<td><span class="term"><em class="parameter"><code>cards</code></em> :</span></td>
834
<div class="refsect2" lang="en">
835
<a name="id2592761"></a><h3>
836
<a name="e-data-book-respond-get-changes"></a>e_data_book_respond_get_changes ()</h3>
837
<a class="indexterm" name="id2592773"></a><pre class="programlisting">void e_data_book_respond_get_changes (<a href="EDataBook.html" title="EDataBook">EDataBook</a> *book,
839
href="/opt/gnome/share/gtk-doc/html/glib/glib-Basic-Types.html#guint32"
841
GNOME_Evolution_Addressbook_CallStatus status,
843
href="/opt/gnome/share/gtk-doc/html/glib/glib-Doubly-Linked-Lists.html#GList"
844
>GList</a> *changes);</pre>
846
Respond to a 'get changes' request specified by <em class="parameter"><code>opid</code></em> on <em class="parameter"><code>book</code></em>,
847
indicating <em class="parameter"><code>status</code></em> as the outcome.</p>
851
<div class="variablelist"><table border="0">
852
<col align="left" valign="top">
855
<td><span class="term"><em class="parameter"><code>book</code></em> :</span></td>
856
<td> an <a href="EDataBook.html" title="EDataBook"><span class="type">EDataBook</span></a>
860
<td><span class="term"><em class="parameter"><code>opid</code></em> :</span></td>
861
<td> the operation ID that generated the response
865
<td><span class="term"><em class="parameter"><code>status</code></em> :</span></td>
866
<td> the outcome of the operation
870
<td><span class="term"><em class="parameter"><code>changes</code></em> :</span></td>
871
<td> a list of GNOME_Evolution_Addressbook_BookChangeItem items
878
<div class="refsect2" lang="en">
879
<a name="id2592902"></a><h3>
880
<a name="e-data-book-report-writable"></a>e_data_book_report_writable ()</h3>
881
<a class="indexterm" name="id2592913"></a><pre class="programlisting">void e_data_book_report_writable (<a href="EDataBook.html" title="EDataBook">EDataBook</a> *book,
883
href="/opt/gnome/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
884
>gboolean</a> writable);</pre>
886
Notify listeners that <em class="parameter"><code>book</code></em>'s writeable status has changed
887
to <em class="parameter"><code>writable</code></em>.</p>
891
<div class="variablelist"><table border="0">
892
<col align="left" valign="top">
895
<td><span class="term"><em class="parameter"><code>book</code></em> :</span></td>
896
<td> an <a href="EDataBook.html" title="EDataBook"><span class="type">EDataBook</span></a>
900
<td><span class="term"><em class="parameter"><code>writable</code></em> :</span></td>
902
href="/opt/gnome/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"
903
><code class="literal">TRUE</code></a> if <em class="parameter"><code>book</code></em> is writeable, <a
904
href="/opt/gnome/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"
905
><code class="literal">FALSE</code></a> otherwise
912
<div class="refsect2" lang="en">
913
<a name="id2593014"></a><h3>
914
<a name="e-data-book-report-connection-status"></a>e_data_book_report_connection_status ()</h3>
915
<a class="indexterm" name="id2593027"></a><pre class="programlisting">void e_data_book_report_connection_status
916
(<a href="EDataBook.html" title="EDataBook">EDataBook</a> *book,
918
href="/opt/gnome/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
919
>gboolean</a> is_online);</pre>
921
Notify listeners that <em class="parameter"><code>book</code></em> requires authentication.</p>
925
<div class="variablelist"><table border="0">
926
<col align="left" valign="top">
929
<td><span class="term"><em class="parameter"><code>book</code></em> :</span></td>
930
<td> an <a href="EDataBook.html" title="EDataBook"><span class="type">EDataBook</span></a>
934
<td><span class="term"><em class="parameter"><code>is_online</code></em> :</span></td>
944
<div class="refsect2" lang="en">
945
<a name="id2593103"></a><h3>
946
<a name="e-data-book-report-auth-required"></a>e_data_book_report_auth_required ()</h3>
947
<a class="indexterm" name="id2593115"></a><pre class="programlisting">void e_data_book_report_auth_required
948
(<a href="EDataBook.html" title="EDataBook">EDataBook</a> *book);</pre>
952
<div class="variablelist"><table border="0">
953
<col align="left" valign="top">
955
<td><span class="term"><em class="parameter"><code>book</code></em> :</span></td>