<?xml version="1.0"?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" 
               "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd">
<refentry id="EDataBook">
<refmeta>
<refentrytitle role="top_of_page" id="EDataBook.top_of_page">EDataBook</refentrytitle>
<manvolnum>3</manvolnum>
<refmiscinfo>LIBEDATA-BOOK Library</refmiscinfo>
</refmeta>

<refnamediv>
<refname>EDataBook</refname>
<refpurpose></refpurpose>
<!--[<xref linkend="desc" endterm="desc.title"/>]-->
</refnamediv>

<refsynopsisdiv id="EDataBook.synopsis" role="synopsis">
<title role="synopsis.title">Synopsis</title>

<synopsis>
struct              <link linkend="EDataBook-struct">EDataBook</link>;
<link linkend="EDataBook">EDataBook</link>*          <link linkend="e-data-book-new">e_data_book_new</link>                     (<link linkend="EBookBackend">EBookBackend</link> *backend,
                                                         <link linkend="ESource">ESource</link> *source,
                                                         <link linkend="GNOME-Evolution-Addressbook-BookListener">GNOME_Evolution_Addressbook_BookListener</link> listener);
<link linkend="GNOME-Evolution-Addressbook-BookListener">GNOME_Evolution_Addressbook_BookListener</link> <link linkend="e-data-book-get-listener">e_data_book_get_listener</link>
                                                        (<link linkend="EDataBook">EDataBook</link> *book);
<link linkend="EBookBackend">EBookBackend</link>*       <link linkend="e-data-book-get-backend">e_data_book_get_backend</link>             (<link linkend="EDataBook">EDataBook</link> *book);
<link linkend="ESource">ESource</link>*            <link linkend="e-data-book-get-source">e_data_book_get_source</link>              (<link linkend="EDataBook">EDataBook</link> *book);
<link linkend="void">void</link>                <link linkend="e-data-book-respond-open">e_data_book_respond_open</link>            (<link linkend="EDataBook">EDataBook</link> *book,
                                                         <link linkend="guint32">guint32</link> opid,
                                                         <link linkend="GNOME-Evolution-Addressbook-CallStatus">GNOME_Evolution_Addressbook_CallStatus</link> status);
<link linkend="void">void</link>                <link linkend="e-data-book-respond-remove">e_data_book_respond_remove</link>          (<link linkend="EDataBook">EDataBook</link> *book,
                                                         <link linkend="guint32">guint32</link> opid,
                                                         <link linkend="GNOME-Evolution-Addressbook-CallStatus">GNOME_Evolution_Addressbook_CallStatus</link> status);
<link linkend="void">void</link>                <link linkend="e-data-book-respond-create">e_data_book_respond_create</link>          (<link linkend="EDataBook">EDataBook</link> *book,
                                                         <link linkend="guint32">guint32</link> opid,
                                                         <link linkend="GNOME-Evolution-Addressbook-CallStatus">GNOME_Evolution_Addressbook_CallStatus</link> status,
                                                         <link linkend="EContact">EContact</link> *contact);
<link linkend="void">void</link>                <link linkend="e-data-book-respond-remove-contacts">e_data_book_respond_remove_contacts</link> (<link linkend="EDataBook">EDataBook</link> *book,
                                                         <link linkend="guint32">guint32</link> opid,
                                                         <link linkend="GNOME-Evolution-Addressbook-CallStatus">GNOME_Evolution_Addressbook_CallStatus</link> status,
                                                         <link linkend="GList">GList</link> *ids);
<link linkend="void">void</link>                <link linkend="e-data-book-respond-modify">e_data_book_respond_modify</link>          (<link linkend="EDataBook">EDataBook</link> *book,
                                                         <link linkend="guint32">guint32</link> opid,
                                                         <link linkend="GNOME-Evolution-Addressbook-CallStatus">GNOME_Evolution_Addressbook_CallStatus</link> status,
                                                         <link linkend="EContact">EContact</link> *contact);
<link linkend="void">void</link>                <link linkend="e-data-book-respond-authenticate-user">e_data_book_respond_authenticate_user</link>
                                                        (<link linkend="EDataBook">EDataBook</link> *book,
                                                         <link linkend="guint32">guint32</link> opid,
                                                         <link linkend="GNOME-Evolution-Addressbook-CallStatus">GNOME_Evolution_Addressbook_CallStatus</link> status);
<link linkend="void">void</link>                <link linkend="e-data-book-respond-get-supported-fields">e_data_book_respond_get_supported_fields</link>
                                                        (<link linkend="EDataBook">EDataBook</link> *book,
                                                         <link linkend="guint32">guint32</link> opid,
                                                         <link linkend="GNOME-Evolution-Addressbook-CallStatus">GNOME_Evolution_Addressbook_CallStatus</link> status,
                                                         <link linkend="GList">GList</link> *fields);
<link linkend="void">void</link>                <link linkend="e-data-book-respond-get-required-fields">e_data_book_respond_get_required_fields</link>
                                                        (<link linkend="EDataBook">EDataBook</link> *book,
                                                         <link linkend="guint32">guint32</link> opid,
                                                         <link linkend="GNOME-Evolution-Addressbook-CallStatus">GNOME_Evolution_Addressbook_CallStatus</link> status,
                                                         <link linkend="GList">GList</link> *fields);
<link linkend="void">void</link>                <link linkend="e-data-book-respond-get-supported-auth-methods">e_data_book_respond_get_supported_auth_methods</link>
                                                        (<link linkend="EDataBook">EDataBook</link> *book,
                                                         <link linkend="guint32">guint32</link> opid,
                                                         <link linkend="GNOME-Evolution-Addressbook-CallStatus">GNOME_Evolution_Addressbook_CallStatus</link> status,
                                                         <link linkend="GList">GList</link> *fields);
<link linkend="void">void</link>                <link linkend="e-data-book-respond-get-book-view">e_data_book_respond_get_book_view</link>   (<link linkend="EDataBook">EDataBook</link> *book,
                                                         <link linkend="guint32">guint32</link> opid,
                                                         <link linkend="GNOME-Evolution-Addressbook-CallStatus">GNOME_Evolution_Addressbook_CallStatus</link> status,
                                                         <link linkend="EDataBookView">EDataBookView</link> *book_view);
<link linkend="void">void</link>                <link linkend="e-data-book-respond-get-contact">e_data_book_respond_get_contact</link>     (<link linkend="EDataBook">EDataBook</link> *book,
                                                         <link linkend="guint32">guint32</link> opid,
                                                         <link linkend="GNOME-Evolution-Addressbook-CallStatus">GNOME_Evolution_Addressbook_CallStatus</link> status,
                                                         <link linkend="char">char</link> *vcard);
<link linkend="void">void</link>                <link linkend="e-data-book-respond-get-contact-list">e_data_book_respond_get_contact_list</link>
                                                        (<link linkend="EDataBook">EDataBook</link> *book,
                                                         <link linkend="guint32">guint32</link> opid,
                                                         <link linkend="GNOME-Evolution-Addressbook-CallStatus">GNOME_Evolution_Addressbook_CallStatus</link> status,
                                                         <link linkend="GList">GList</link> *cards);
<link linkend="void">void</link>                <link linkend="e-data-book-respond-get-changes">e_data_book_respond_get_changes</link>     (<link linkend="EDataBook">EDataBook</link> *book,
                                                         <link linkend="guint32">guint32</link> opid,
                                                         <link linkend="GNOME-Evolution-Addressbook-CallStatus">GNOME_Evolution_Addressbook_CallStatus</link> status,
                                                         <link linkend="GList">GList</link> *changes);
<link linkend="void">void</link>                <link linkend="e-data-book-report-writable">e_data_book_report_writable</link>         (<link linkend="EDataBook">EDataBook</link> *book,
                                                         <link linkend="gboolean">gboolean</link> writable);
<link linkend="void">void</link>                <link linkend="e-data-book-report-connection-status">e_data_book_report_connection_status</link>
                                                        (<link linkend="EDataBook">EDataBook</link> *book,
                                                         <link linkend="gboolean">gboolean</link> is_online);
<link linkend="void">void</link>                <link linkend="e-data-book-report-auth-required">e_data_book_report_auth_required</link>    (<link linkend="EDataBook">EDataBook</link> *book);
</synopsis>
</refsynopsisdiv>

<refsect1 id="EDataBook.object-hierarchy" role="object_hierarchy">
<title role="object_hierarchy.title">Object Hierarchy</title>
<synopsis>
  <link linkend="GObject">GObject</link>
   +----<link linkend="BonoboObject">BonoboObject</link>
         +----EDataBook
</synopsis>

</refsect1>








<refsect1 id="EDataBook.description" role="desc">
<title role="desc.title">Description</title>
<para>

</para>
</refsect1>

<refsect1 id="EDataBook.details" role="details">
<title role="details.title">Details</title>
<refsect2 id="EDataBook-struct" role="struct">
<title>struct EDataBook</title>
<indexterm zone="EDataBook-struct"><primary>EDataBook</primary></indexterm><programlisting>struct EDataBook;</programlisting>
<para>

</para></refsect2>
<refsect2 id="e-data-book-new" role="function">
<title>e_data_book_new ()</title>
<indexterm zone="e-data-book-new"><primary>e_data_book_new</primary></indexterm><programlisting><link linkend="EDataBook">EDataBook</link>*          e_data_book_new                     (<link linkend="EBookBackend">EBookBackend</link> *backend,
                                                         <link linkend="ESource">ESource</link> *source,
                                                         <link linkend="GNOME-Evolution-Addressbook-BookListener">GNOME_Evolution_Addressbook_BookListener</link> listener);</programlisting>
<para>
Create a new <link linkend="EDataBook"><type>EDataBook</type></link> using <parameter>backend</parameter> for storage, <parameter>source</parameter> as the
storage location and <parameter>listener</parameter> for reporting status.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>backend</parameter>&nbsp;:</term>
<listitem><simpara> an <link linkend="EBookBackend"><type>EBookBackend</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>source</parameter>&nbsp;:</term>
<listitem><simpara> an <link linkend="ESource"><type>ESource</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>listener</parameter>&nbsp;:</term>
<listitem><simpara> a <link linkend="GNOME-Evolution-Addressbook-BookListener"><type>GNOME_Evolution_Addressbook_BookListener</type></link> CORBA object
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara> A new <link linkend="EDataBook"><type>EDataBook</type></link>.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="e-data-book-get-listener" role="function">
<title>e_data_book_get_listener ()</title>
<indexterm zone="e-data-book-get-listener"><primary>e_data_book_get_listener</primary></indexterm><programlisting><link linkend="GNOME-Evolution-Addressbook-BookListener">GNOME_Evolution_Addressbook_BookListener</link> e_data_book_get_listener
                                                        (<link linkend="EDataBook">EDataBook</link> *book);</programlisting>
<para>
Gets the CORBA listener associated with <parameter>book</parameter>.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>book</parameter>&nbsp;:</term>
<listitem><simpara> an <link linkend="EDataBook"><type>EDataBook</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara> A <link linkend="GNOME-Evolution-Addressbook-BookListener"><type>GNOME_Evolution_Addressbook_BookListener</type></link>.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="e-data-book-get-backend" role="function">
<title>e_data_book_get_backend ()</title>
<indexterm zone="e-data-book-get-backend"><primary>e_data_book_get_backend</primary></indexterm><programlisting><link linkend="EBookBackend">EBookBackend</link>*       e_data_book_get_backend             (<link linkend="EDataBook">EDataBook</link> *book);</programlisting>
<para>
Gets the <link linkend="EBookBackend"><type>EBookBackend</type></link> being used to store data for <parameter>book</parameter>.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>book</parameter>&nbsp;:</term>
<listitem><simpara> an <link linkend="EDataBook"><type>EDataBook</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara> The <link linkend="EBookBackend"><type>EBookBackend</type></link> being used.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="e-data-book-get-source" role="function">
<title>e_data_book_get_source ()</title>
<indexterm zone="e-data-book-get-source"><primary>e_data_book_get_source</primary></indexterm><programlisting><link linkend="ESource">ESource</link>*            e_data_book_get_source              (<link linkend="EDataBook">EDataBook</link> *book);</programlisting>
<para>
Gets the <link linkend="ESource"><type>ESource</type></link> associated with <parameter>book</parameter>.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>book</parameter>&nbsp;:</term>
<listitem><simpara> an <link linkend="EDataBook"><type>EDataBook</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara> An <link linkend="ESource"><type>ESource</type></link>.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="e-data-book-respond-open" role="function">
<title>e_data_book_respond_open ()</title>
<indexterm zone="e-data-book-respond-open"><primary>e_data_book_respond_open</primary></indexterm><programlisting><link linkend="void">void</link>                e_data_book_respond_open            (<link linkend="EDataBook">EDataBook</link> *book,
                                                         <link linkend="guint32">guint32</link> opid,
                                                         <link linkend="GNOME-Evolution-Addressbook-CallStatus">GNOME_Evolution_Addressbook_CallStatus</link> status);</programlisting>
<para>
Respond to an 'open' request specified by <parameter>opid</parameter> on <parameter>book</parameter>,
indicating <parameter>status</parameter> as the outcome.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>book</parameter>&nbsp;:</term>
<listitem><simpara> an <link linkend="EDataBook"><type>EDataBook</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>opid</parameter>&nbsp;:</term>
<listitem><simpara> the operation ID that generated the response
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>status</parameter>&nbsp;:</term>
<listitem><simpara> the outcome of the operation
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="e-data-book-respond-remove" role="function">
<title>e_data_book_respond_remove ()</title>
<indexterm zone="e-data-book-respond-remove"><primary>e_data_book_respond_remove</primary></indexterm><programlisting><link linkend="void">void</link>                e_data_book_respond_remove          (<link linkend="EDataBook">EDataBook</link> *book,
                                                         <link linkend="guint32">guint32</link> opid,
                                                         <link linkend="GNOME-Evolution-Addressbook-CallStatus">GNOME_Evolution_Addressbook_CallStatus</link> status);</programlisting>
<para>
Respond to a 'remove' request to remove all of <parameter>book</parameter>'s data,
specified by <parameter>opid</parameter>, indicating <parameter>status</parameter> as the outcome.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>book</parameter>&nbsp;:</term>
<listitem><simpara> an <link linkend="EDataBook"><type>EDataBook</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>opid</parameter>&nbsp;:</term>
<listitem><simpara> the operation ID that generated the response
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>status</parameter>&nbsp;:</term>
<listitem><simpara> the outcome of the operation
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="e-data-book-respond-create" role="function">
<title>e_data_book_respond_create ()</title>
<indexterm zone="e-data-book-respond-create"><primary>e_data_book_respond_create</primary></indexterm><programlisting><link linkend="void">void</link>                e_data_book_respond_create          (<link linkend="EDataBook">EDataBook</link> *book,
                                                         <link linkend="guint32">guint32</link> opid,
                                                         <link linkend="GNOME-Evolution-Addressbook-CallStatus">GNOME_Evolution_Addressbook_CallStatus</link> status,
                                                         <link linkend="EContact">EContact</link> *contact);</programlisting>
<para>
Respond to a 'create' request specified by <parameter>opid</parameter> on <parameter>book</parameter>,
indicating <parameter>status</parameter> as the outcome.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>book</parameter>&nbsp;:</term>
<listitem><simpara> an <link linkend="EDataBook"><type>EDataBook</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>opid</parameter>&nbsp;:</term>
<listitem><simpara> the operation ID that generated the response
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>status</parameter>&nbsp;:</term>
<listitem><simpara> the outcome of the operation
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>contact</parameter>&nbsp;:</term>
<listitem><simpara> the contact created, or <link linkend="NULL:CAPS"><literal>NULL</literal></link>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="e-data-book-respond-remove-contacts" role="function">
<title>e_data_book_respond_remove_contacts ()</title>
<indexterm zone="e-data-book-respond-remove-contacts"><primary>e_data_book_respond_remove_contacts</primary></indexterm><programlisting><link linkend="void">void</link>                e_data_book_respond_remove_contacts (<link linkend="EDataBook">EDataBook</link> *book,
                                                         <link linkend="guint32">guint32</link> opid,
                                                         <link linkend="GNOME-Evolution-Addressbook-CallStatus">GNOME_Evolution_Addressbook_CallStatus</link> status,
                                                         <link linkend="GList">GList</link> *ids);</programlisting>
<para>
Respond to a 'remove contacts' request specified by <parameter>opid</parameter> on <parameter>book</parameter>,
indicating <parameter>status</parameter> as the outcome.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>book</parameter>&nbsp;:</term>
<listitem><simpara> an <link linkend="EDataBook"><type>EDataBook</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>opid</parameter>&nbsp;:</term>
<listitem><simpara> the operation ID that generated the response
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>status</parameter>&nbsp;:</term>
<listitem><simpara> the outcome of the operation
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>ids</parameter>&nbsp;:</term>
<listitem><simpara> a list of contact IDs removed
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="e-data-book-respond-modify" role="function">
<title>e_data_book_respond_modify ()</title>
<indexterm zone="e-data-book-respond-modify"><primary>e_data_book_respond_modify</primary></indexterm><programlisting><link linkend="void">void</link>                e_data_book_respond_modify          (<link linkend="EDataBook">EDataBook</link> *book,
                                                         <link linkend="guint32">guint32</link> opid,
                                                         <link linkend="GNOME-Evolution-Addressbook-CallStatus">GNOME_Evolution_Addressbook_CallStatus</link> status,
                                                         <link linkend="EContact">EContact</link> *contact);</programlisting>
<para>
Respond to a 'modify' request specified by <parameter>opid</parameter> on <parameter>book</parameter>,
indicating <parameter>status</parameter> as the outcome.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>book</parameter>&nbsp;:</term>
<listitem><simpara> an <link linkend="EDataBook"><type>EDataBook</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>opid</parameter>&nbsp;:</term>
<listitem><simpara> the operation ID that generated the response
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>status</parameter>&nbsp;:</term>
<listitem><simpara> the outcome of the operation
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>contact</parameter>&nbsp;:</term>
<listitem><simpara> the modified <link linkend="EContact"><type>EContact</type></link>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="e-data-book-respond-authenticate-user" role="function">
<title>e_data_book_respond_authenticate_user ()</title>
<indexterm zone="e-data-book-respond-authenticate-user"><primary>e_data_book_respond_authenticate_user</primary></indexterm><programlisting><link linkend="void">void</link>                e_data_book_respond_authenticate_user
                                                        (<link linkend="EDataBook">EDataBook</link> *book,
                                                         <link linkend="guint32">guint32</link> opid,
                                                         <link linkend="GNOME-Evolution-Addressbook-CallStatus">GNOME_Evolution_Addressbook_CallStatus</link> status);</programlisting>
<para>
Respond to an 'authenticate' request specified by <parameter>opid</parameter> on <parameter>book</parameter>,
indicating <parameter>status</parameter> as the outcome.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>book</parameter>&nbsp;:</term>
<listitem><simpara> an <link linkend="EDataBook"><type>EDataBook</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>opid</parameter>&nbsp;:</term>
<listitem><simpara> the operation ID that generated the response
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>status</parameter>&nbsp;:</term>
<listitem><simpara> the outcome of the operation
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="e-data-book-respond-get-supported-fields" role="function">
<title>e_data_book_respond_get_supported_fields ()</title>
<indexterm zone="e-data-book-respond-get-supported-fields"><primary>e_data_book_respond_get_supported_fields</primary></indexterm><programlisting><link linkend="void">void</link>                e_data_book_respond_get_supported_fields
                                                        (<link linkend="EDataBook">EDataBook</link> *book,
                                                         <link linkend="guint32">guint32</link> opid,
                                                         <link linkend="GNOME-Evolution-Addressbook-CallStatus">GNOME_Evolution_Addressbook_CallStatus</link> status,
                                                         <link linkend="GList">GList</link> *fields);</programlisting>
<para>
Respond to a 'get supported fields' request specified by <parameter>opid</parameter> on <parameter>book</parameter>,
indicating <parameter>status</parameter> as the outcome.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>book</parameter>&nbsp;:</term>
<listitem><simpara> an <link linkend="EDataBook"><type>EDataBook</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>opid</parameter>&nbsp;:</term>
<listitem><simpara> the operation ID that generated the response
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>status</parameter>&nbsp;:</term>
<listitem><simpara> the outcome of the operation
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>fields</parameter>&nbsp;:</term>
<listitem><simpara> a list of supported field names
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="e-data-book-respond-get-required-fields" role="function">
<title>e_data_book_respond_get_required_fields ()</title>
<indexterm zone="e-data-book-respond-get-required-fields"><primary>e_data_book_respond_get_required_fields</primary></indexterm><programlisting><link linkend="void">void</link>                e_data_book_respond_get_required_fields
                                                        (<link linkend="EDataBook">EDataBook</link> *book,
                                                         <link linkend="guint32">guint32</link> opid,
                                                         <link linkend="GNOME-Evolution-Addressbook-CallStatus">GNOME_Evolution_Addressbook_CallStatus</link> status,
                                                         <link linkend="GList">GList</link> *fields);</programlisting>
<para>
Respond to a 'get required fields' request specified by <parameter>opid</parameter> on <parameter>book</parameter>,
indicating <parameter>status</parameter> as the outcome.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>book</parameter>&nbsp;:</term>
<listitem><simpara> an <link linkend="EDataBook"><type>EDataBook</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>opid</parameter>&nbsp;:</term>
<listitem><simpara> the operation ID that generated the response
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>status</parameter>&nbsp;:</term>
<listitem><simpara> the outcome of the operation
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>fields</parameter>&nbsp;:</term>
<listitem><simpara> a list of required field names
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="e-data-book-respond-get-supported-auth-methods" role="function">
<title>e_data_book_respond_get_supported_auth_methods ()</title>
<indexterm zone="e-data-book-respond-get-supported-auth-methods"><primary>e_data_book_respond_get_supported_auth_methods</primary></indexterm><programlisting><link linkend="void">void</link>                e_data_book_respond_get_supported_auth_methods
                                                        (<link linkend="EDataBook">EDataBook</link> *book,
                                                         <link linkend="guint32">guint32</link> opid,
                                                         <link linkend="GNOME-Evolution-Addressbook-CallStatus">GNOME_Evolution_Addressbook_CallStatus</link> status,
                                                         <link linkend="GList">GList</link> *fields);</programlisting>
<para>
Respond to a 'get supported auth methods' request specified by <parameter>opid</parameter> on <parameter>book</parameter>,
indicating <parameter>status</parameter> as the outcome.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>book</parameter>&nbsp;:</term>
<listitem><simpara> an <link linkend="EDataBook"><type>EDataBook</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>opid</parameter>&nbsp;:</term>
<listitem><simpara> the operation ID that generated the response
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>status</parameter>&nbsp;:</term>
<listitem><simpara> the outcome of the operation
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>fields</parameter>&nbsp;:</term>
<listitem><simpara>


</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="e-data-book-respond-get-book-view" role="function">
<title>e_data_book_respond_get_book_view ()</title>
<indexterm zone="e-data-book-respond-get-book-view"><primary>e_data_book_respond_get_book_view</primary></indexterm><programlisting><link linkend="void">void</link>                e_data_book_respond_get_book_view   (<link linkend="EDataBook">EDataBook</link> *book,
                                                         <link linkend="guint32">guint32</link> opid,
                                                         <link linkend="GNOME-Evolution-Addressbook-CallStatus">GNOME_Evolution_Addressbook_CallStatus</link> status,
                                                         <link linkend="EDataBookView">EDataBookView</link> *book_view);</programlisting>
<para>
Respond to a 'get book view' request specified by <parameter>opid</parameter> on <parameter>book</parameter>,
indicating <parameter>status</parameter> as the outcome.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>book</parameter>&nbsp;:</term>
<listitem><simpara> an <link linkend="EDataBook"><type>EDataBook</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>opid</parameter>&nbsp;:</term>
<listitem><simpara> the operation ID that generated the response
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>status</parameter>&nbsp;:</term>
<listitem><simpara> the outcome of the operation
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>book_view</parameter>&nbsp;:</term>
<listitem><simpara> the <link linkend="EDataBookView"><type>EDataBookView</type></link> created
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="e-data-book-respond-get-contact" role="function">
<title>e_data_book_respond_get_contact ()</title>
<indexterm zone="e-data-book-respond-get-contact"><primary>e_data_book_respond_get_contact</primary></indexterm><programlisting><link linkend="void">void</link>                e_data_book_respond_get_contact     (<link linkend="EDataBook">EDataBook</link> *book,
                                                         <link linkend="guint32">guint32</link> opid,
                                                         <link linkend="GNOME-Evolution-Addressbook-CallStatus">GNOME_Evolution_Addressbook_CallStatus</link> status,
                                                         <link linkend="char">char</link> *vcard);</programlisting>
<para>
Respond to a 'get contact' request specified by <parameter>opid</parameter> on <parameter>book</parameter>,
indicating <parameter>status</parameter> as the outcome.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>book</parameter>&nbsp;:</term>
<listitem><simpara> an <link linkend="EDataBook"><type>EDataBook</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>opid</parameter>&nbsp;:</term>
<listitem><simpara> the operation ID that generated the response
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>status</parameter>&nbsp;:</term>
<listitem><simpara> the outcome of the operation
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>vcard</parameter>&nbsp;:</term>
<listitem><simpara> the found VCard, or <link linkend="NULL:CAPS"><literal>NULL</literal></link>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="e-data-book-respond-get-contact-list" role="function">
<title>e_data_book_respond_get_contact_list ()</title>
<indexterm zone="e-data-book-respond-get-contact-list"><primary>e_data_book_respond_get_contact_list</primary></indexterm><programlisting><link linkend="void">void</link>                e_data_book_respond_get_contact_list
                                                        (<link linkend="EDataBook">EDataBook</link> *book,
                                                         <link linkend="guint32">guint32</link> opid,
                                                         <link linkend="GNOME-Evolution-Addressbook-CallStatus">GNOME_Evolution_Addressbook_CallStatus</link> status,
                                                         <link linkend="GList">GList</link> *cards);</programlisting>
<para>
Respond to a 'get contact list' request specified by <parameter>opid</parameter> on <parameter>book</parameter>,
indicating <parameter>status</parameter> as the outcome.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>book</parameter>&nbsp;:</term>
<listitem><simpara> an <link linkend="EDataBook"><type>EDataBook</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>opid</parameter>&nbsp;:</term>
<listitem><simpara> the operation ID that generated the response
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>status</parameter>&nbsp;:</term>
<listitem><simpara> the outcome of the operation
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>cards</parameter>&nbsp;:</term>
<listitem><simpara>


</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="e-data-book-respond-get-changes" role="function">
<title>e_data_book_respond_get_changes ()</title>
<indexterm zone="e-data-book-respond-get-changes"><primary>e_data_book_respond_get_changes</primary></indexterm><programlisting><link linkend="void">void</link>                e_data_book_respond_get_changes     (<link linkend="EDataBook">EDataBook</link> *book,
                                                         <link linkend="guint32">guint32</link> opid,
                                                         <link linkend="GNOME-Evolution-Addressbook-CallStatus">GNOME_Evolution_Addressbook_CallStatus</link> status,
                                                         <link linkend="GList">GList</link> *changes);</programlisting>
<para>
Respond to a 'get changes' request specified by <parameter>opid</parameter> on <parameter>book</parameter>,
indicating <parameter>status</parameter> as the outcome.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>book</parameter>&nbsp;:</term>
<listitem><simpara> an <link linkend="EDataBook"><type>EDataBook</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>opid</parameter>&nbsp;:</term>
<listitem><simpara> the operation ID that generated the response
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>status</parameter>&nbsp;:</term>
<listitem><simpara> the outcome of the operation
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>changes</parameter>&nbsp;:</term>
<listitem><simpara> a list of GNOME_Evolution_Addressbook_BookChangeItem items
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="e-data-book-report-writable" role="function">
<title>e_data_book_report_writable ()</title>
<indexterm zone="e-data-book-report-writable"><primary>e_data_book_report_writable</primary></indexterm><programlisting><link linkend="void">void</link>                e_data_book_report_writable         (<link linkend="EDataBook">EDataBook</link> *book,
                                                         <link linkend="gboolean">gboolean</link> writable);</programlisting>
<para>
Notify listeners that <parameter>book</parameter>'s writeable status has changed
to <parameter>writable</parameter>.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>book</parameter>&nbsp;:</term>
<listitem><simpara> an <link linkend="EDataBook"><type>EDataBook</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>writable</parameter>&nbsp;:</term>
<listitem><simpara> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> if <parameter>book</parameter> is writeable, <link linkend="FALSE:CAPS"><literal>FALSE</literal></link> otherwise
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="e-data-book-report-connection-status" role="function">
<title>e_data_book_report_connection_status ()</title>
<indexterm zone="e-data-book-report-connection-status"><primary>e_data_book_report_connection_status</primary></indexterm><programlisting><link linkend="void">void</link>                e_data_book_report_connection_status
                                                        (<link linkend="EDataBook">EDataBook</link> *book,
                                                         <link linkend="gboolean">gboolean</link> is_online);</programlisting>
<para>
Notify listeners that <parameter>book</parameter> requires authentication.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>book</parameter>&nbsp;:</term>
<listitem><simpara> an <link linkend="EDataBook"><type>EDataBook</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>is_online</parameter>&nbsp;:</term>
<listitem><simpara>


</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="e-data-book-report-auth-required" role="function">
<title>e_data_book_report_auth_required ()</title>
<indexterm zone="e-data-book-report-auth-required"><primary>e_data_book_report_auth_required</primary></indexterm><programlisting><link linkend="void">void</link>                e_data_book_report_auth_required    (<link linkend="EDataBook">EDataBook</link> *book);</programlisting>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>book</parameter>&nbsp;:</term>
<listitem><simpara>


</simpara></listitem></varlistentry>
</variablelist></refsect2>

</refsect1>




</refentry>
