| Server IP : 182.53.201.61 / Your IP : 216.73.217.175 Web Server : Apache/2.2.15 (Fedora) System : Linux km10.dyndns.org 2.6.31.5-127.fc12.i686.PAE #1 SMP Sat Nov 7 21:25:57 EST 2009 i686 User : apache ( 48) PHP Version : 5.3.3 Disable Function : NONE MySQL : ON | cURL : ON | WGET : ON | Perl : ON | Python : ON | Sudo : ON | Pkexec : ON Directory : /usr/share/gtk-doc/html/camel/ |
Upload File : |
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>CamelFolder</title>
<meta name="generator" content="DocBook XSL Stylesheets V1.75.2">
<link rel="home" href="index.html" title="Camel Reference Manual">
<link rel="up" href="Folders.html" title="Folders">
<link rel="prev" href="Folders.html" title="Folders">
<link rel="next" href="camel-CamelFolderSearch.html" title="CamelFolderSearch">
<meta name="generator" content="GTK-Doc V1.11 (XML mode)">
<link rel="stylesheet" href="style.css" type="text/css">
<link rel="part" href="classes.html" title="Part I. Camel Classes">
<link rel="chapter" href="ClassTree.html" title="Class Hierarchy">
<link rel="chapter" href="Fundamentals.html" title="Fundamentals">
<link rel="chapter" href="Streams.html" title="Streams">
<link rel="chapter" href="StreamFilters.html" title="Stream Filters">
<link rel="chapter" href="Services.html" title="Services">
<link rel="chapter" href="Filters.html" title="Filters">
<link rel="chapter" href="Folders.html" title="Folders">
<link rel="chapter" href="SearchFolders.html" title="Search Folders">
<link rel="chapter" href="Addresses.html" title="Addresses">
<link rel="chapter" href="Crypto.html" title="Crypto Contexts">
<link rel="chapter" href="MIME.html" title="MIME Objects">
<link rel="chapter" href="Storage.html" title="Metadata Storage">
<link rel="chapter" href="Utilities.html" title="Utilities">
<link rel="chapter" href="Deprecated.html" title="Deprecated Objects">
<link rel="index" href="ix01.html" title="Index">
<link rel="index" href="ix02.html" title="Index of deprecated symbols">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
<tr valign="middle">
<td><a accesskey="p" href="Folders.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
<td><a accesskey="u" href="Folders.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
<th width="100%" align="center">Camel Reference Manual</th>
<td><a accesskey="n" href="camel-CamelFolderSearch.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
</tr>
<tr><td colspan="5" class="shortcuts">
<a href="#camel-CamelFolder.synopsis" class="shortcut">Top</a>
|
<a href="#camel-CamelFolder.description" class="shortcut">Description</a>
</td></tr>
</table>
<div class="refentry" title="CamelFolder">
<a name="camel-CamelFolder"></a><div class="titlepage"></div>
<div class="refnamediv"><table width="100%"><tr>
<td valign="top">
<h2><span class="refentrytitle"><a name="camel-CamelFolder.top_of_page"></a>CamelFolder</span></h2>
<p>CamelFolder</p>
</td>
<td valign="top" align="right"></td>
</tr></table></div>
<div class="refsynopsisdiv" title="Synopsis">
<a name="camel-CamelFolder.synopsis"></a><h2>Synopsis</h2>
<pre class="synopsis">
struct <a class="link" href="camel-CamelFolder.html#CamelFolder" title="struct CamelFolder">CamelFolder</a>;
<a class="link" href="camel-CamelFolder.html#CamelFolderChangeInfo" title="CamelFolderChangeInfo">CamelFolderChangeInfo</a>;
<a class="link" href="camel-CamelFolder.html#CamelFolderQuotaInfo" title="CamelFolderQuotaInfo">CamelFolderQuotaInfo</a>;
#define <a class="link" href="camel-CamelFolder.html#CAMEL-FOLDER-HAS-SUMMARY-CAPABILITY--CAPS" title="CAMEL_FOLDER_HAS_SUMMARY_CAPABILITY">CAMEL_FOLDER_HAS_SUMMARY_CAPABILITY</a>
#define <a class="link" href="camel-CamelFolder.html#CAMEL-FOLDER-HAS-SEARCH-CAPABILITY--CAPS" title="CAMEL_FOLDER_HAS_SEARCH_CAPABILITY">CAMEL_FOLDER_HAS_SEARCH_CAPABILITY</a>
#define <a class="link" href="camel-CamelFolder.html#CAMEL-FOLDER-FILTER-RECENT--CAPS" title="CAMEL_FOLDER_FILTER_RECENT">CAMEL_FOLDER_FILTER_RECENT</a>
#define <a class="link" href="camel-CamelFolder.html#CAMEL-FOLDER-HAS-BEEN-DELETED--CAPS" title="CAMEL_FOLDER_HAS_BEEN_DELETED">CAMEL_FOLDER_HAS_BEEN_DELETED</a>
#define <a class="link" href="camel-CamelFolder.html#CAMEL-FOLDER-IS-TRASH--CAPS" title="CAMEL_FOLDER_IS_TRASH">CAMEL_FOLDER_IS_TRASH</a>
#define <a class="link" href="camel-CamelFolder.html#CAMEL-FOLDER-IS-JUNK--CAPS" title="CAMEL_FOLDER_IS_JUNK">CAMEL_FOLDER_IS_JUNK</a>
#define <a class="link" href="camel-CamelFolder.html#CAMEL-FOLDER-FILTER-JUNK--CAPS" title="CAMEL_FOLDER_FILTER_JUNK">CAMEL_FOLDER_FILTER_JUNK</a>
void <a class="link" href="camel-CamelFolder.html#camel-folder-construct" title="camel_folder_construct ()">camel_folder_construct</a> (<a class="link" href="camel-CamelFolder.html#CamelFolder" title="struct CamelFolder">CamelFolder</a> *folder,
<a class="link" href="camel-CamelStore.html#CamelStore" title="struct CamelStore">CamelStore</a> *parent_store,
const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *full_name,
const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *name);
void <a class="link" href="camel-CamelFolder.html#camel-folder-refresh-info" title="camel_folder_refresh_info ()">camel_folder_refresh_info</a> (<a class="link" href="camel-CamelFolder.html#CamelFolder" title="struct CamelFolder">CamelFolder</a> *folder,
<a class="link" href="camel-camel-exception.html#CamelException" title="struct CamelException">CamelException</a> *ex);
void <a class="link" href="camel-CamelFolder.html#camel-folder-sync" title="camel_folder_sync ()">camel_folder_sync</a> (<a class="link" href="camel-CamelFolder.html#CamelFolder" title="struct CamelFolder">CamelFolder</a> *folder,
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a> expunge,
<a class="link" href="camel-camel-exception.html#CamelException" title="struct CamelException">CamelException</a> *ex);
<a class="link" href="camel-CamelStore.html#CamelStore" title="struct CamelStore">CamelStore</a> * <a class="link" href="camel-CamelFolder.html#camel-folder-get-parent-store" title="camel_folder_get_parent_store ()">camel_folder_get_parent_store</a> (<a class="link" href="camel-CamelFolder.html#CamelFolder" title="struct CamelFolder">CamelFolder</a> *folder);
void <a class="link" href="camel-CamelFolder.html#camel-folder-expunge" title="camel_folder_expunge ()">camel_folder_expunge</a> (<a class="link" href="camel-CamelFolder.html#CamelFolder" title="struct CamelFolder">CamelFolder</a> *folder,
<a class="link" href="camel-camel-exception.html#CamelException" title="struct CamelException">CamelException</a> *ex);
const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> * <a class="link" href="camel-CamelFolder.html#camel-folder-get-name" title="camel_folder_get_name ()">camel_folder_get_name</a> (<a class="link" href="camel-CamelFolder.html#CamelFolder" title="struct CamelFolder">CamelFolder</a> *folder);
const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> * <a class="link" href="camel-CamelFolder.html#camel-folder-get-full-name" title="camel_folder_get_full_name ()">camel_folder_get_full_name</a> (<a class="link" href="camel-CamelFolder.html#CamelFolder" title="struct CamelFolder">CamelFolder</a> *folder);
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint32"
>guint32</a> <a class="link" href="camel-CamelFolder.html#camel-folder-get-permanent-flags" title="camel_folder_get_permanent_flags ()">camel_folder_get_permanent_flags</a> (<a class="link" href="camel-CamelFolder.html#CamelFolder" title="struct CamelFolder">CamelFolder</a> *folder);
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint32"
>guint32</a> <a class="link" href="camel-CamelFolder.html#camel-folder-get-message-flags" title="camel_folder_get_message_flags ()">camel_folder_get_message_flags</a> (<a class="link" href="camel-CamelFolder.html#CamelFolder" title="struct CamelFolder">CamelFolder</a> *folder,
const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *uid);
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a> <a class="link" href="camel-CamelFolder.html#camel-folder-set-message-flags" title="camel_folder_set_message_flags ()">camel_folder_set_message_flags</a> (<a class="link" href="camel-CamelFolder.html#CamelFolder" title="struct CamelFolder">CamelFolder</a> *folder,
const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *uid,
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint32"
>guint32</a> flags,
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint32"
>guint32</a> set);
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a> <a class="link" href="camel-CamelFolder.html#camel-folder-get-message-user-flag" title="camel_folder_get_message_user_flag ()">camel_folder_get_message_user_flag</a> (<a class="link" href="camel-CamelFolder.html#CamelFolder" title="struct CamelFolder">CamelFolder</a> *folder,
const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *uid,
const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *name);
void <a class="link" href="camel-CamelFolder.html#camel-folder-set-message-user-flag" title="camel_folder_set_message_user_flag ()">camel_folder_set_message_user_flag</a> (<a class="link" href="camel-CamelFolder.html#CamelFolder" title="struct CamelFolder">CamelFolder</a> *folder,
const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *uid,
const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *name,
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a> value);
const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> * <a class="link" href="camel-CamelFolder.html#camel-folder-get-message-user-tag" title="camel_folder_get_message_user_tag ()">camel_folder_get_message_user_tag</a> (<a class="link" href="camel-CamelFolder.html#CamelFolder" title="struct CamelFolder">CamelFolder</a> *folder,
const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *uid,
const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *name);
void <a class="link" href="camel-CamelFolder.html#camel-folder-set-message-user-tag" title="camel_folder_set_message_user_tag ()">camel_folder_set_message_user_tag</a> (<a class="link" href="camel-CamelFolder.html#CamelFolder" title="struct CamelFolder">CamelFolder</a> *folder,
const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *uid,
const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *name,
const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *value);
void <a class="link" href="camel-CamelFolder.html#camel-folder-append-message" title="camel_folder_append_message ()">camel_folder_append_message</a> (<a class="link" href="camel-CamelFolder.html#CamelFolder" title="struct CamelFolder">CamelFolder</a> *folder,
<a class="link" href="camel-CamelMimeMessage.html#CamelMimeMessage" title="struct CamelMimeMessage">CamelMimeMessage</a> *message,
const <a class="link" href="camel-CamelFolderSummary.html#CamelMessageInfo" title="CamelMessageInfo">CamelMessageInfo</a> *info,
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> **appended_uid,
<a class="link" href="camel-camel-exception.html#CamelException" title="struct CamelException">CamelException</a> *ex);
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a> <a class="link" href="camel-CamelFolder.html#camel-folder-has-summary-capability" title="camel_folder_has_summary_capability ()">camel_folder_has_summary_capability</a> (<a class="link" href="camel-CamelFolder.html#CamelFolder" title="struct CamelFolder">CamelFolder</a> *folder);
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a> <a class="link" href="camel-CamelFolder.html#camel-folder-get-message-count" title="camel_folder_get_message_count ()">camel_folder_get_message_count</a> (<a class="link" href="camel-CamelFolder.html#CamelFolder" title="struct CamelFolder">CamelFolder</a> *folder);
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a> <a class="link" href="camel-CamelFolder.html#camel-folder-get-unread-message-count" title="camel_folder_get_unread_message_count ()">camel_folder_get_unread_message_count</a>
(<a class="link" href="camel-CamelFolder.html#CamelFolder" title="struct CamelFolder">CamelFolder</a> *folder);
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a> <a class="link" href="camel-CamelFolder.html#camel-folder-get-deleted-message-count" title="camel_folder_get_deleted_message_count ()">camel_folder_get_deleted_message_count</a>
(<a class="link" href="camel-CamelFolder.html#CamelFolder" title="struct CamelFolder">CamelFolder</a> *folder);
<a
href="/usr/share/gtk-doc/html/glib/glib-Pointer-Arrays.html#GPtrArray"
>GPtrArray</a> * <a class="link" href="camel-CamelFolder.html#camel-folder-get-summary" title="camel_folder_get_summary ()">camel_folder_get_summary</a> (<a class="link" href="camel-CamelFolder.html#CamelFolder" title="struct CamelFolder">CamelFolder</a> *folder);
void <a class="link" href="camel-CamelFolder.html#camel-folder-free-summary" title="camel_folder_free_summary ()">camel_folder_free_summary</a> (<a class="link" href="camel-CamelFolder.html#CamelFolder" title="struct CamelFolder">CamelFolder</a> *folder,
<a
href="/usr/share/gtk-doc/html/glib/glib-Pointer-Arrays.html#GPtrArray"
>GPtrArray</a> *array);
<a class="link" href="camel-CamelMimeMessage.html#CamelMimeMessage" title="struct CamelMimeMessage">CamelMimeMessage</a> * <a class="link" href="camel-CamelFolder.html#camel-folder-get-message" title="camel_folder_get_message ()">camel_folder_get_message</a> (<a class="link" href="camel-CamelFolder.html#CamelFolder" title="struct CamelFolder">CamelFolder</a> *folder,
const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *uid,
<a class="link" href="camel-camel-exception.html#CamelException" title="struct CamelException">CamelException</a> *ex);
void <a class="link" href="camel-CamelFolder.html#camel-folder-sync-message" title="camel_folder_sync_message ()">camel_folder_sync_message</a> (<a class="link" href="camel-CamelFolder.html#CamelFolder" title="struct CamelFolder">CamelFolder</a> *folder,
const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *uid,
<a class="link" href="camel-camel-exception.html#CamelException" title="struct CamelException">CamelException</a> *ex);
#define <a class="link" href="camel-CamelFolder.html#camel-folder-delete-message" title="camel_folder_delete_message()">camel_folder_delete_message</a> (folder, uid)
<a
href="/usr/share/gtk-doc/html/glib/glib-Pointer-Arrays.html#GPtrArray"
>GPtrArray</a> * <a class="link" href="camel-CamelFolder.html#camel-folder-get-uids" title="camel_folder_get_uids ()">camel_folder_get_uids</a> (<a class="link" href="camel-CamelFolder.html#CamelFolder" title="struct CamelFolder">CamelFolder</a> *folder);
void <a class="link" href="camel-CamelFolder.html#camel-folder-free-uids" title="camel_folder_free_uids ()">camel_folder_free_uids</a> (<a class="link" href="camel-CamelFolder.html#CamelFolder" title="struct CamelFolder">CamelFolder</a> *folder,
<a
href="/usr/share/gtk-doc/html/glib/glib-Pointer-Arrays.html#GPtrArray"
>GPtrArray</a> *array);
<a
href="/usr/share/gtk-doc/html/glib/glib-Pointer-Arrays.html#GPtrArray"
>GPtrArray</a> * <a class="link" href="camel-CamelFolder.html#camel-folder-get-uncached-uids" title="camel_folder_get_uncached_uids ()">camel_folder_get_uncached_uids</a> (<a class="link" href="camel-CamelFolder.html#CamelFolder" title="struct CamelFolder">CamelFolder</a> *,
<a
href="/usr/share/gtk-doc/html/glib/glib-Pointer-Arrays.html#GPtrArray"
>GPtrArray</a> *uids,
<a class="link" href="camel-camel-exception.html#CamelException" title="struct CamelException">CamelException</a> *);
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a> <a class="link" href="camel-CamelFolder.html#camel-folder-cmp-uids" title="camel_folder_cmp_uids ()">camel_folder_cmp_uids</a> (<a class="link" href="camel-CamelFolder.html#CamelFolder" title="struct CamelFolder">CamelFolder</a> *folder,
const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *uid1,
const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *uid2);
void <a class="link" href="camel-CamelFolder.html#camel-folder-sort-uids" title="camel_folder_sort_uids ()">camel_folder_sort_uids</a> (<a class="link" href="camel-CamelFolder.html#CamelFolder" title="struct CamelFolder">CamelFolder</a> *folder,
<a
href="/usr/share/gtk-doc/html/glib/glib-Pointer-Arrays.html#GPtrArray"
>GPtrArray</a> *uids);
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a> <a class="link" href="camel-CamelFolder.html#camel-folder-has-search-capability" title="camel_folder_has_search_capability ()">camel_folder_has_search_capability</a> (<a class="link" href="camel-CamelFolder.html#CamelFolder" title="struct CamelFolder">CamelFolder</a> *folder);
<a
href="/usr/share/gtk-doc/html/glib/glib-Pointer-Arrays.html#GPtrArray"
>GPtrArray</a> * <a class="link" href="camel-CamelFolder.html#camel-folder-search-by-expression" title="camel_folder_search_by_expression ()">camel_folder_search_by_expression</a> (<a class="link" href="camel-CamelFolder.html#CamelFolder" title="struct CamelFolder">CamelFolder</a> *folder,
const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *expr,
<a class="link" href="camel-camel-exception.html#CamelException" title="struct CamelException">CamelException</a> *ex);
<a
href="/usr/share/gtk-doc/html/glib/glib-Pointer-Arrays.html#GPtrArray"
>GPtrArray</a> * <a class="link" href="camel-CamelFolder.html#camel-folder-search-by-uids" title="camel_folder_search_by_uids ()">camel_folder_search_by_uids</a> (<a class="link" href="camel-CamelFolder.html#CamelFolder" title="struct CamelFolder">CamelFolder</a> *folder,
const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *expr,
<a
href="/usr/share/gtk-doc/html/glib/glib-Pointer-Arrays.html#GPtrArray"
>GPtrArray</a> *uids,
<a class="link" href="camel-camel-exception.html#CamelException" title="struct CamelException">CamelException</a> *ex);
void <a class="link" href="camel-CamelFolder.html#camel-folder-search-free" title="camel_folder_search_free ()">camel_folder_search_free</a> (<a class="link" href="camel-CamelFolder.html#CamelFolder" title="struct CamelFolder">CamelFolder</a> *folder,
<a
href="/usr/share/gtk-doc/html/glib/glib-Pointer-Arrays.html#GPtrArray"
>GPtrArray</a> *result);
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint32"
>guint32</a> <a class="link" href="camel-CamelFolder.html#camel-folder-count-by-expression" title="camel_folder_count_by_expression ()">camel_folder_count_by_expression</a> (<a class="link" href="camel-CamelFolder.html#CamelFolder" title="struct CamelFolder">CamelFolder</a> *folder,
const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *expression,
<a class="link" href="camel-camel-exception.html#CamelException" title="struct CamelException">CamelException</a> *ex);
<a class="link" href="camel-CamelFolderSummary.html#CamelMessageInfo" title="CamelMessageInfo">CamelMessageInfo</a> * <a class="link" href="camel-CamelFolder.html#camel-folder-get-message-info" title="camel_folder_get_message_info ()">camel_folder_get_message_info</a> (<a class="link" href="camel-CamelFolder.html#CamelFolder" title="struct CamelFolder">CamelFolder</a> *folder,
const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *uid);
void <a class="link" href="camel-CamelFolder.html#camel-folder-free-message-info" title="camel_folder_free_message_info ()">camel_folder_free_message_info</a> (<a class="link" href="camel-CamelFolder.html#CamelFolder" title="struct CamelFolder">CamelFolder</a> *folder,
<a class="link" href="camel-CamelFolderSummary.html#CamelMessageInfo" title="CamelMessageInfo">CamelMessageInfo</a> *info);
void <a class="link" href="camel-CamelFolder.html#camel-folder-ref-message-info" title="camel_folder_ref_message_info ()">camel_folder_ref_message_info</a> (<a class="link" href="camel-CamelFolder.html#CamelFolder" title="struct CamelFolder">CamelFolder</a> *folder,
<a class="link" href="camel-CamelFolderSummary.html#CamelMessageInfo" title="CamelMessageInfo">CamelMessageInfo</a> *info);
void <a class="link" href="camel-CamelFolder.html#camel-folder-transfer-messages-to" title="camel_folder_transfer_messages_to ()">camel_folder_transfer_messages_to</a> (<a class="link" href="camel-CamelFolder.html#CamelFolder" title="struct CamelFolder">CamelFolder</a> *source,
<a
href="/usr/share/gtk-doc/html/glib/glib-Pointer-Arrays.html#GPtrArray"
>GPtrArray</a> *uids,
<a class="link" href="camel-CamelFolder.html#CamelFolder" title="struct CamelFolder">CamelFolder</a> *dest,
<a
href="/usr/share/gtk-doc/html/glib/glib-Pointer-Arrays.html#GPtrArray"
>GPtrArray</a> **transferred_uids,
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a> delete_originals,
<a class="link" href="camel-camel-exception.html#CamelException" title="struct CamelException">CamelException</a> *ex);
void <a class="link" href="camel-CamelFolder.html#camel-folder-delete" title="camel_folder_delete ()">camel_folder_delete</a> (<a class="link" href="camel-CamelFolder.html#CamelFolder" title="struct CamelFolder">CamelFolder</a> *folder);
void <a class="link" href="camel-CamelFolder.html#camel-folder-rename" title="camel_folder_rename ()">camel_folder_rename</a> (<a class="link" href="camel-CamelFolder.html#CamelFolder" title="struct CamelFolder">CamelFolder</a> *folder,
const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *new);
void <a class="link" href="camel-CamelFolder.html#camel-folder-freeze" title="camel_folder_freeze ()">camel_folder_freeze</a> (<a class="link" href="camel-CamelFolder.html#CamelFolder" title="struct CamelFolder">CamelFolder</a> *folder);
void <a class="link" href="camel-CamelFolder.html#camel-folder-thaw" title="camel_folder_thaw ()">camel_folder_thaw</a> (<a class="link" href="camel-CamelFolder.html#CamelFolder" title="struct CamelFolder">CamelFolder</a> *folder);
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a> <a class="link" href="camel-CamelFolder.html#camel-folder-is-frozen" title="camel_folder_is_frozen ()">camel_folder_is_frozen</a> (<a class="link" href="camel-CamelFolder.html#CamelFolder" title="struct CamelFolder">CamelFolder</a> *folder);
<a class="link" href="camel-CamelFolder.html#CamelFolderQuotaInfo" title="CamelFolderQuotaInfo">CamelFolderQuotaInfo</a> * <a class="link" href="camel-CamelFolder.html#camel-folder-get-quota-info" title="camel_folder_get_quota_info ()">camel_folder_get_quota_info</a> (<a class="link" href="camel-CamelFolder.html#CamelFolder" title="struct CamelFolder">CamelFolder</a> *folder);
<a class="link" href="camel-CamelFolder.html#CamelFolderQuotaInfo" title="CamelFolderQuotaInfo">CamelFolderQuotaInfo</a> * <a class="link" href="camel-CamelFolder.html#camel-folder-quota-info-new" title="camel_folder_quota_info_new ()">camel_folder_quota_info_new</a> (const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *name,
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint64"
>guint64</a> used,
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint64"
>guint64</a> total);
<a class="link" href="camel-CamelFolder.html#CamelFolderQuotaInfo" title="CamelFolderQuotaInfo">CamelFolderQuotaInfo</a> * <a class="link" href="camel-CamelFolder.html#camel-folder-quota-info-clone" title="camel_folder_quota_info_clone ()">camel_folder_quota_info_clone</a> (const <a class="link" href="camel-CamelFolder.html#CamelFolderQuotaInfo" title="CamelFolderQuotaInfo">CamelFolderQuotaInfo</a> *info);
void <a class="link" href="camel-CamelFolder.html#camel-folder-quota-info-free" title="camel_folder_quota_info_free ()">camel_folder_quota_info_free</a> (<a class="link" href="camel-CamelFolder.html#CamelFolderQuotaInfo" title="CamelFolderQuotaInfo">CamelFolderQuotaInfo</a> *info);
void <a class="link" href="camel-CamelFolder.html#camel-folder-free-nop" title="camel_folder_free_nop ()">camel_folder_free_nop</a> (<a class="link" href="camel-CamelFolder.html#CamelFolder" title="struct CamelFolder">CamelFolder</a> *folder,
<a
href="/usr/share/gtk-doc/html/glib/glib-Pointer-Arrays.html#GPtrArray"
>GPtrArray</a> *array);
void <a class="link" href="camel-CamelFolder.html#camel-folder-free-shallow" title="camel_folder_free_shallow ()">camel_folder_free_shallow</a> (<a class="link" href="camel-CamelFolder.html#CamelFolder" title="struct CamelFolder">CamelFolder</a> *folder,
<a
href="/usr/share/gtk-doc/html/glib/glib-Pointer-Arrays.html#GPtrArray"
>GPtrArray</a> *array);
void <a class="link" href="camel-CamelFolder.html#camel-folder-free-deep" title="camel_folder_free_deep ()">camel_folder_free_deep</a> (<a class="link" href="camel-CamelFolder.html#CamelFolder" title="struct CamelFolder">CamelFolder</a> *folder,
<a
href="/usr/share/gtk-doc/html/glib/glib-Pointer-Arrays.html#GPtrArray"
>GPtrArray</a> *array);
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> * <a class="link" href="camel-CamelFolder.html#camel-folder-get-filename" title="camel_folder_get_filename ()">camel_folder_get_filename</a> (<a class="link" href="camel-CamelFolder.html#CamelFolder" title="struct CamelFolder">CamelFolder</a> *folder,
const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *uid,
<a class="link" href="camel-camel-exception.html#CamelException" title="struct CamelException">CamelException</a> *ex);
<a class="link" href="camel-CamelFolder.html#CamelFolderChangeInfo" title="CamelFolderChangeInfo">CamelFolderChangeInfo</a> * <a class="link" href="camel-CamelFolder.html#camel-folder-change-info-new" title="camel_folder_change_info_new ()">camel_folder_change_info_new</a> (void);
void <a class="link" href="camel-CamelFolder.html#camel-folder-change-info-clear" title="camel_folder_change_info_clear ()">camel_folder_change_info_clear</a> (<a class="link" href="camel-CamelFolder.html#CamelFolderChangeInfo" title="CamelFolderChangeInfo">CamelFolderChangeInfo</a> *info);
void <a class="link" href="camel-CamelFolder.html#camel-folder-change-info-free" title="camel_folder_change_info_free ()">camel_folder_change_info_free</a> (<a class="link" href="camel-CamelFolder.html#CamelFolderChangeInfo" title="CamelFolderChangeInfo">CamelFolderChangeInfo</a> *info);
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a> <a class="link" href="camel-CamelFolder.html#camel-folder-change-info-changed" title="camel_folder_change_info_changed ()">camel_folder_change_info_changed</a> (<a class="link" href="camel-CamelFolder.html#CamelFolderChangeInfo" title="CamelFolderChangeInfo">CamelFolderChangeInfo</a> *info);
void <a class="link" href="camel-CamelFolder.html#camel-folder-change-info-add-source" title="camel_folder_change_info_add_source ()">camel_folder_change_info_add_source</a> (<a class="link" href="camel-CamelFolder.html#CamelFolderChangeInfo" title="CamelFolderChangeInfo">CamelFolderChangeInfo</a> *info,
const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *uid);
void <a class="link" href="camel-CamelFolder.html#camel-folder-change-info-add-source-list" title="camel_folder_change_info_add_source_list ()">camel_folder_change_info_add_source_list</a>
(<a class="link" href="camel-CamelFolder.html#CamelFolderChangeInfo" title="CamelFolderChangeInfo">CamelFolderChangeInfo</a> *info,
const <a
href="/usr/share/gtk-doc/html/glib/glib-Pointer-Arrays.html#GPtrArray"
>GPtrArray</a> *list);
void <a class="link" href="camel-CamelFolder.html#camel-folder-change-info-add-update" title="camel_folder_change_info_add_update ()">camel_folder_change_info_add_update</a> (<a class="link" href="camel-CamelFolder.html#CamelFolderChangeInfo" title="CamelFolderChangeInfo">CamelFolderChangeInfo</a> *info,
const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *uid);
void <a class="link" href="camel-CamelFolder.html#camel-folder-change-info-add-update-list" title="camel_folder_change_info_add_update_list ()">camel_folder_change_info_add_update_list</a>
(<a class="link" href="camel-CamelFolder.html#CamelFolderChangeInfo" title="CamelFolderChangeInfo">CamelFolderChangeInfo</a> *info,
const <a
href="/usr/share/gtk-doc/html/glib/glib-Pointer-Arrays.html#GPtrArray"
>GPtrArray</a> *list);
void <a class="link" href="camel-CamelFolder.html#camel-folder-change-info-build-diff" title="camel_folder_change_info_build_diff ()">camel_folder_change_info_build_diff</a> (<a class="link" href="camel-CamelFolder.html#CamelFolderChangeInfo" title="CamelFolderChangeInfo">CamelFolderChangeInfo</a> *info);
void <a class="link" href="camel-CamelFolder.html#camel-folder-change-info-cat" title="camel_folder_change_info_cat ()">camel_folder_change_info_cat</a> (<a class="link" href="camel-CamelFolder.html#CamelFolderChangeInfo" title="CamelFolderChangeInfo">CamelFolderChangeInfo</a> *info,
<a class="link" href="camel-CamelFolder.html#CamelFolderChangeInfo" title="CamelFolderChangeInfo">CamelFolderChangeInfo</a> *src);
void <a class="link" href="camel-CamelFolder.html#camel-folder-change-info-add-uid" title="camel_folder_change_info_add_uid ()">camel_folder_change_info_add_uid</a> (<a class="link" href="camel-CamelFolder.html#CamelFolderChangeInfo" title="CamelFolderChangeInfo">CamelFolderChangeInfo</a> *info,
const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *uid);
void <a class="link" href="camel-CamelFolder.html#camel-folder-change-info-remove-uid" title="camel_folder_change_info_remove_uid ()">camel_folder_change_info_remove_uid</a> (<a class="link" href="camel-CamelFolder.html#CamelFolderChangeInfo" title="CamelFolderChangeInfo">CamelFolderChangeInfo</a> *info,
const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *uid);
void <a class="link" href="camel-CamelFolder.html#camel-folder-change-info-change-uid" title="camel_folder_change_info_change_uid ()">camel_folder_change_info_change_uid</a> (<a class="link" href="camel-CamelFolder.html#CamelFolderChangeInfo" title="CamelFolderChangeInfo">CamelFolderChangeInfo</a> *info,
const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *uid);
void <a class="link" href="camel-CamelFolder.html#camel-folder-change-info-recent-uid" title="camel_folder_change_info_recent_uid ()">camel_folder_change_info_recent_uid</a> (<a class="link" href="camel-CamelFolder.html#CamelFolderChangeInfo" title="CamelFolderChangeInfo">CamelFolderChangeInfo</a> *info,
const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *uid);
</pre>
</div>
<div class="refsect1" title="Description">
<a name="camel-CamelFolder.description"></a><h2>Description</h2>
<p>
</p>
</div>
<div class="refsect1" title="Details">
<a name="camel-CamelFolder.details"></a><h2>Details</h2>
<div class="refsect2" title="struct CamelFolder">
<a name="CamelFolder"></a><h3>struct CamelFolder</h3>
<pre class="programlisting">struct CamelFolder {
CamelObject parent_object;
struct _CamelFolderPrivate *priv;
/* get these via the :get() method, they might not be set otherwise */
gchar *name;
gchar *full_name;
gchar *description;
CamelStore *parent_store;
CamelFolderSummary *summary;
guint32 folder_flags;
guint32 permanent_flags;
/* Future ABI expansion */
gpointer later[4];
};
</pre>
<p>
</p>
</div>
<hr>
<div class="refsect2" title="CamelFolderChangeInfo">
<a name="CamelFolderChangeInfo"></a><h3>CamelFolderChangeInfo</h3>
<pre class="programlisting">typedef struct {
GPtrArray *uid_added;
GPtrArray *uid_removed;
GPtrArray *uid_changed;
GPtrArray *uid_recent;
struct _CamelFolderChangeInfoPrivate *priv;
} CamelFolderChangeInfo;
</pre>
<p>
</p>
</div>
<hr>
<div class="refsect2" title="CamelFolderQuotaInfo">
<a name="CamelFolderQuotaInfo"></a><h3>CamelFolderQuotaInfo</h3>
<pre class="programlisting">typedef struct {
gchar *name;
guint64 used;
guint64 total;
struct _CamelFolderQuotaInfo *next;
} CamelFolderQuotaInfo;
</pre>
<p>
</p>
</div>
<hr>
<div class="refsect2" title="CAMEL_FOLDER_HAS_SUMMARY_CAPABILITY">
<a name="CAMEL-FOLDER-HAS-SUMMARY-CAPABILITY--CAPS"></a><h3>CAMEL_FOLDER_HAS_SUMMARY_CAPABILITY</h3>
<pre class="programlisting">#define CAMEL_FOLDER_HAS_SUMMARY_CAPABILITY (1<<0)
</pre>
<p>
</p>
</div>
<hr>
<div class="refsect2" title="CAMEL_FOLDER_HAS_SEARCH_CAPABILITY">
<a name="CAMEL-FOLDER-HAS-SEARCH-CAPABILITY--CAPS"></a><h3>CAMEL_FOLDER_HAS_SEARCH_CAPABILITY</h3>
<pre class="programlisting">#define CAMEL_FOLDER_HAS_SEARCH_CAPABILITY (1<<1)
</pre>
<p>
</p>
</div>
<hr>
<div class="refsect2" title="CAMEL_FOLDER_FILTER_RECENT">
<a name="CAMEL-FOLDER-FILTER-RECENT--CAPS"></a><h3>CAMEL_FOLDER_FILTER_RECENT</h3>
<pre class="programlisting">#define CAMEL_FOLDER_FILTER_RECENT (1<<2)
</pre>
<p>
</p>
</div>
<hr>
<div class="refsect2" title="CAMEL_FOLDER_HAS_BEEN_DELETED">
<a name="CAMEL-FOLDER-HAS-BEEN-DELETED--CAPS"></a><h3>CAMEL_FOLDER_HAS_BEEN_DELETED</h3>
<pre class="programlisting">#define CAMEL_FOLDER_HAS_BEEN_DELETED (1<<3)
</pre>
<p>
</p>
</div>
<hr>
<div class="refsect2" title="CAMEL_FOLDER_IS_TRASH">
<a name="CAMEL-FOLDER-IS-TRASH--CAPS"></a><h3>CAMEL_FOLDER_IS_TRASH</h3>
<pre class="programlisting">#define CAMEL_FOLDER_IS_TRASH (1<<4)
</pre>
<p>
</p>
</div>
<hr>
<div class="refsect2" title="CAMEL_FOLDER_IS_JUNK">
<a name="CAMEL-FOLDER-IS-JUNK--CAPS"></a><h3>CAMEL_FOLDER_IS_JUNK</h3>
<pre class="programlisting">#define CAMEL_FOLDER_IS_JUNK (1<<5)
</pre>
<p>
</p>
</div>
<hr>
<div class="refsect2" title="CAMEL_FOLDER_FILTER_JUNK">
<a name="CAMEL-FOLDER-FILTER-JUNK--CAPS"></a><h3>CAMEL_FOLDER_FILTER_JUNK</h3>
<pre class="programlisting">#define CAMEL_FOLDER_FILTER_JUNK (1<<6)
</pre>
<p>
</p>
</div>
<hr>
<div class="refsect2" title="camel_folder_construct ()">
<a name="camel-folder-construct"></a><h3>camel_folder_construct ()</h3>
<pre class="programlisting">void camel_folder_construct (<a class="link" href="camel-CamelFolder.html#CamelFolder" title="struct CamelFolder">CamelFolder</a> *folder,
<a class="link" href="camel-CamelStore.html#CamelStore" title="struct CamelStore">CamelStore</a> *parent_store,
const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *full_name,
const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *name);</pre>
<p>
Initalizes the folder by setting the parent store and name.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>folder</code></em> :</span></p></td>
<td> a <a class="link" href="camel-CamelFolder.html#CamelFolder" title="struct CamelFolder"><span class="type">CamelFolder</span></a> object to construct
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>parent_store</code></em> :</span></p></td>
<td> parent <a class="link" href="camel-CamelStore.html#CamelStore" title="struct CamelStore"><span class="type">CamelStore</span></a> object of the folder
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>full_name</code></em> :</span></p></td>
<td> full name of the folder
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>name</code></em> :</span></p></td>
<td> short name of the folder
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" title="camel_folder_refresh_info ()">
<a name="camel-folder-refresh-info"></a><h3>camel_folder_refresh_info ()</h3>
<pre class="programlisting">void camel_folder_refresh_info (<a class="link" href="camel-CamelFolder.html#CamelFolder" title="struct CamelFolder">CamelFolder</a> *folder,
<a class="link" href="camel-camel-exception.html#CamelException" title="struct CamelException">CamelException</a> *ex);</pre>
<p>
Updates a folder's summary to be in sync with its backing store.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>folder</code></em> :</span></p></td>
<td> a <a class="link" href="camel-CamelFolder.html#CamelFolder" title="struct CamelFolder"><span class="type">CamelFolder</span></a> object
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>ex</code></em> :</span></p></td>
<td> a <a class="link" href="camel-camel-exception.html#CamelException" title="struct CamelException"><span class="type">CamelException</span></a>
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" title="camel_folder_sync ()">
<a name="camel-folder-sync"></a><h3>camel_folder_sync ()</h3>
<pre class="programlisting">void camel_folder_sync (<a class="link" href="camel-CamelFolder.html#CamelFolder" title="struct CamelFolder">CamelFolder</a> *folder,
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a> expunge,
<a class="link" href="camel-camel-exception.html#CamelException" title="struct CamelException">CamelException</a> *ex);</pre>
<p>
Sync changes made to a folder to its backing store, possibly
expunging deleted messages as well.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>folder</code></em> :</span></p></td>
<td> a <a class="link" href="camel-CamelFolder.html#CamelFolder" title="struct CamelFolder"><span class="type">CamelFolder</span></a> object
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>expunge</code></em> :</span></p></td>
<td> whether or not to expunge deleted messages
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>ex</code></em> :</span></p></td>
<td> a <a class="link" href="camel-camel-exception.html#CamelException" title="struct CamelException"><span class="type">CamelException</span></a>
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" title="camel_folder_get_parent_store ()">
<a name="camel-folder-get-parent-store"></a><h3>camel_folder_get_parent_store ()</h3>
<pre class="programlisting"><a class="link" href="camel-CamelStore.html#CamelStore" title="struct CamelStore">CamelStore</a> * camel_folder_get_parent_store (<a class="link" href="camel-CamelFolder.html#CamelFolder" title="struct CamelFolder">CamelFolder</a> *folder);</pre>
<p>
</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>folder</code></em> :</span></p></td>
<td> a <a class="link" href="camel-CamelFolder.html#CamelFolder" title="struct CamelFolder"><span class="type">CamelFolder</span></a> object
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> the parent <a class="link" href="camel-CamelStore.html#CamelStore" title="struct CamelStore"><span class="type">CamelStore</span></a> of the folder
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" title="camel_folder_expunge ()">
<a name="camel-folder-expunge"></a><h3>camel_folder_expunge ()</h3>
<pre class="programlisting">void camel_folder_expunge (<a class="link" href="camel-CamelFolder.html#CamelFolder" title="struct CamelFolder">CamelFolder</a> *folder,
<a class="link" href="camel-camel-exception.html#CamelException" title="struct CamelException">CamelException</a> *ex);</pre>
<p>
Delete messages which have been marked as "DELETED"</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>folder</code></em> :</span></p></td>
<td> a <a class="link" href="camel-CamelFolder.html#CamelFolder" title="struct CamelFolder"><span class="type">CamelFolder</span></a> object
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>ex</code></em> :</span></p></td>
<td> a <a class="link" href="camel-camel-exception.html#CamelException" title="struct CamelException"><span class="type">CamelException</span></a>
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" title="camel_folder_get_name ()">
<a name="camel-folder-get-name"></a><h3>camel_folder_get_name ()</h3>
<pre class="programlisting">const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> * camel_folder_get_name (<a class="link" href="camel-CamelFolder.html#CamelFolder" title="struct CamelFolder">CamelFolder</a> *folder);</pre>
<p>
Get the (short) name of the folder. The fully qualified name
can be obtained with the <a class="link" href="camel-CamelFolder.html#camel-folder-get-full-name" title="camel_folder_get_full_name ()"><span class="type">camel_folder_get_full_name</span></a> method.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>folder</code></em> :</span></p></td>
<td> a <a class="link" href="camel-CamelFolder.html#CamelFolder" title="struct CamelFolder"><span class="type">CamelFolder</span></a> object
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> the short name of the folder
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" title="camel_folder_get_full_name ()">
<a name="camel-folder-get-full-name"></a><h3>camel_folder_get_full_name ()</h3>
<pre class="programlisting">const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> * camel_folder_get_full_name (<a class="link" href="camel-CamelFolder.html#CamelFolder" title="struct CamelFolder">CamelFolder</a> *folder);</pre>
<p>
Get the full name of the folder.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>folder</code></em> :</span></p></td>
<td> a <a class="link" href="camel-CamelFolder.html#CamelFolder" title="struct CamelFolder"><span class="type">CamelFolder</span></a> object
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> the full name of the folder
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" title="camel_folder_get_permanent_flags ()">
<a name="camel-folder-get-permanent-flags"></a><h3>camel_folder_get_permanent_flags ()</h3>
<pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint32"
>guint32</a> camel_folder_get_permanent_flags (<a class="link" href="camel-CamelFolder.html#CamelFolder" title="struct CamelFolder">CamelFolder</a> *folder);</pre>
<p>
</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>folder</code></em> :</span></p></td>
<td> a <a class="link" href="camel-CamelFolder.html#CamelFolder" title="struct CamelFolder"><span class="type">CamelFolder</span></a> object
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> the set of <a class="link" href="camel-CamelFolderSummary.html#CamelMessageFlags" title="enum CamelMessageFlags"><span class="type">CamelMessageFlags</span></a> that can be permanently
stored on a message between sessions. If it includes
<span class="type">CAMEL_FLAG_USER</span>, then user-defined flags will be remembered.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" title="camel_folder_get_message_flags ()">
<a name="camel-folder-get-message-flags"></a><h3>camel_folder_get_message_flags ()</h3>
<pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint32"
>guint32</a> camel_folder_get_message_flags (<a class="link" href="camel-CamelFolder.html#CamelFolder" title="struct CamelFolder">CamelFolder</a> *folder,
const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *uid);</pre>
<div class="warning" title="Warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">camel_folder_get_message_flags</code> is deprecated and should not be used in newly-written code. Use <a class="link" href="camel-CamelFolder.html#camel-folder-get-message-info" title="camel_folder_get_message_info ()"><span class="type">camel_folder_get_message_info</span></a> instead.</p>
</div>
<p>
</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>folder</code></em> :</span></p></td>
<td> a <a class="link" href="camel-CamelFolder.html#CamelFolder" title="struct CamelFolder"><span class="type">CamelFolder</span></a> object
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>uid</code></em> :</span></p></td>
<td> the UID of a message in <em class="parameter"><code>folder</code></em>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> the <a class="link" href="camel-CamelFolderSummary.html#CamelMessageFlags" title="enum CamelMessageFlags"><span class="type">CamelMessageFlags</span></a> that are set on the indicated
message.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" title="camel_folder_set_message_flags ()">
<a name="camel-folder-set-message-flags"></a><h3>camel_folder_set_message_flags ()</h3>
<pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a> camel_folder_set_message_flags (<a class="link" href="camel-CamelFolder.html#CamelFolder" title="struct CamelFolder">CamelFolder</a> *folder,
const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *uid,
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint32"
>guint32</a> flags,
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint32"
>guint32</a> set);</pre>
<div class="warning" title="Warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">camel_folder_set_message_flags</code> is deprecated and should not be used in newly-written code. Use <a class="link" href="camel-CamelFolderSummary.html#camel-message-info-set-flags" title="camel_message_info_set_flags ()"><span class="type">camel_message_info_set_flags</span></a> on the message info directly
(when it works)</p>
</div>
<p>
Sets those flags specified by <em class="parameter"><code>flags</code></em> to the values specified by <em class="parameter"><code>set</code></em>
on the indicated message. (This may or may not persist after the
folder or store is closed. See <a class="link" href="camel-CamelFolder.html#camel-folder-get-permanent-flags" title="camel_folder_get_permanent_flags ()"><span class="type">camel_folder_get_permanent_flags</span></a>)
</p>
<p>
E.g. to set the deleted flag and clear the draft flag, use
<a class="link" href="camel-CamelFolder.html#camel-folder-set-message-flags" title="camel_folder_set_message_flags ()"><span class="type">camel_folder_set_message_flags</span></a>(folder, uid, CAMEL_MESSAGE_DELETED|CAMEL_MESSAGE_DRAFT, CAMEL_MESSAGE_DELETED);</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>folder</code></em> :</span></p></td>
<td> a <a class="link" href="camel-CamelFolder.html#CamelFolder" title="struct CamelFolder"><span class="type">CamelFolder</span></a> object
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>uid</code></em> :</span></p></td>
<td> the UID of a message in <em class="parameter"><code>folder</code></em>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>flags</code></em> :</span></p></td>
<td> a set of <span class="type">CamelMessageFlag</span> values to set
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>set</code></em> :</span></p></td>
<td> the mask of values in <em class="parameter"><code>flags</code></em> to use.
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE--CAPS"
><code class="literal">TRUE</code></a> if the flags were changed or <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE--CAPS"
><code class="literal">FALSE</code></a> otherwise
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" title="camel_folder_get_message_user_flag ()">
<a name="camel-folder-get-message-user-flag"></a><h3>camel_folder_get_message_user_flag ()</h3>
<pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a> camel_folder_get_message_user_flag (<a class="link" href="camel-CamelFolder.html#CamelFolder" title="struct CamelFolder">CamelFolder</a> *folder,
const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *uid,
const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *name);</pre>
<div class="warning" title="Warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">camel_folder_get_message_user_flag</code> is deprecated and should not be used in newly-written code. Use <span class="type">camel_message_info_get_user_flag</span> on the message
info directly</p>
</div>
<p>
</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>folder</code></em> :</span></p></td>
<td> a <a class="link" href="camel-CamelFolder.html#CamelFolder" title="struct CamelFolder"><span class="type">CamelFolder</span></a> object
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>uid</code></em> :</span></p></td>
<td> the UID of a message in <em class="parameter"><code>folder</code></em>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>name</code></em> :</span></p></td>
<td> the name of a user flag
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE--CAPS"
><code class="literal">TRUE</code></a> if the given user flag is set on the message or
<a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE--CAPS"
><code class="literal">FALSE</code></a> otherwise
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" title="camel_folder_set_message_user_flag ()">
<a name="camel-folder-set-message-user-flag"></a><h3>camel_folder_set_message_user_flag ()</h3>
<pre class="programlisting">void camel_folder_set_message_user_flag (<a class="link" href="camel-CamelFolder.html#CamelFolder" title="struct CamelFolder">CamelFolder</a> *folder,
const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *uid,
const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *name,
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a> value);</pre>
<div class="warning" title="Warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">camel_folder_set_message_user_flag</code> is deprecated and should not be used in newly-written code. Use <a class="link" href="camel-CamelFolderSummary.html#camel-message-info-set-user-flag" title="camel_message_info_set_user_flag ()"><span class="type">camel_message_info_set_user_flag</span></a> on the
<a class="link" href="camel-CamelFolderSummary.html#CamelMessageInfo" title="CamelMessageInfo"><span class="type">CamelMessageInfo</span></a> directly (when it works)
</p>
<p>
Sets the user flag specified by <em class="parameter"><code>name</code></em> to the value specified by <em class="parameter"><code>value</code></em>
on the indicated message. (This may or may not persist after the
folder or store is closed. See <a class="link" href="camel-CamelFolder.html#camel-folder-get-permanent-flags" title="camel_folder_get_permanent_flags ()"><span class="type">camel_folder_get_permanent_flags</span></a>)</p>
</div>
<p>
</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>folder</code></em> :</span></p></td>
<td> a <a class="link" href="camel-CamelFolder.html#CamelFolder" title="struct CamelFolder"><span class="type">CamelFolder</span></a> object
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>uid</code></em> :</span></p></td>
<td> the UID of a message in <em class="parameter"><code>folder</code></em>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>name</code></em> :</span></p></td>
<td> the name of the user flag to set
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
<td> the value to set it to
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" title="camel_folder_get_message_user_tag ()">
<a name="camel-folder-get-message-user-tag"></a><h3>camel_folder_get_message_user_tag ()</h3>
<pre class="programlisting">const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> * camel_folder_get_message_user_tag (<a class="link" href="camel-CamelFolder.html#CamelFolder" title="struct CamelFolder">CamelFolder</a> *folder,
const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *uid,
const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *name);</pre>
<div class="warning" title="Warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">camel_folder_get_message_user_tag</code> is deprecated and should not be used in newly-written code. Use <span class="type">camel_message_info_get_user_tag</span> on the
<a class="link" href="camel-CamelFolderSummary.html#CamelMessageInfo" title="CamelMessageInfo"><span class="type">CamelMessageInfo</span></a> directly.</p>
</div>
<p>
</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>folder</code></em> :</span></p></td>
<td> a <a class="link" href="camel-CamelFolder.html#CamelFolder" title="struct CamelFolder"><span class="type">CamelFolder</span></a> object
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>uid</code></em> :</span></p></td>
<td> the UID of a message in <em class="parameter"><code>folder</code></em>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>name</code></em> :</span></p></td>
<td> the name of a user tag
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> the value of the user tag
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" title="camel_folder_set_message_user_tag ()">
<a name="camel-folder-set-message-user-tag"></a><h3>camel_folder_set_message_user_tag ()</h3>
<pre class="programlisting">void camel_folder_set_message_user_tag (<a class="link" href="camel-CamelFolder.html#CamelFolder" title="struct CamelFolder">CamelFolder</a> *folder,
const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *uid,
const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *name,
const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *value);</pre>
<div class="warning" title="Warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">camel_folder_set_message_user_tag</code> is deprecated and should not be used in newly-written code. Use <a class="link" href="camel-CamelFolderSummary.html#camel-message-info-set-user-tag" title="camel_message_info_set_user_tag ()"><span class="type">camel_message_info_set_user_tag</span></a> on the
<a class="link" href="camel-CamelFolderSummary.html#CamelMessageInfo" title="CamelMessageInfo"><span class="type">CamelMessageInfo</span></a> directly (when it works).
</p>
<p>
Sets the user tag specified by <em class="parameter"><code>name</code></em> to the value specified by <em class="parameter"><code>value</code></em>
on the indicated message. (This may or may not persist after the
folder or store is closed. See <a class="link" href="camel-CamelFolder.html#camel-folder-get-permanent-flags" title="camel_folder_get_permanent_flags ()"><span class="type">camel_folder_get_permanent_flags</span></a>)</p>
</div>
<p>
</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>folder</code></em> :</span></p></td>
<td> a <a class="link" href="camel-CamelFolder.html#CamelFolder" title="struct CamelFolder"><span class="type">CamelFolder</span></a> object
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>uid</code></em> :</span></p></td>
<td> the UID of a message in <em class="parameter"><code>folder</code></em>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>name</code></em> :</span></p></td>
<td> the name of the user tag to set
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
<td> the value to set it to
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" title="camel_folder_append_message ()">
<a name="camel-folder-append-message"></a><h3>camel_folder_append_message ()</h3>
<pre class="programlisting">void camel_folder_append_message (<a class="link" href="camel-CamelFolder.html#CamelFolder" title="struct CamelFolder">CamelFolder</a> *folder,
<a class="link" href="camel-CamelMimeMessage.html#CamelMimeMessage" title="struct CamelMimeMessage">CamelMimeMessage</a> *message,
const <a class="link" href="camel-CamelFolderSummary.html#CamelMessageInfo" title="CamelMessageInfo">CamelMessageInfo</a> *info,
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> **appended_uid,
<a class="link" href="camel-camel-exception.html#CamelException" title="struct CamelException">CamelException</a> *ex);</pre>
<p>
Append <em class="parameter"><code>message</code></em> to <em class="parameter"><code>folder</code></em>. Only the flag and tag data from <em class="parameter"><code>info</code></em>
are used. If <em class="parameter"><code>info</code></em> is <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL--CAPS"
><code class="literal">NULL</code></a>, no flags or tags will be set.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>folder</code></em> :</span></p></td>
<td> a <a class="link" href="camel-CamelFolder.html#CamelFolder" title="struct CamelFolder"><span class="type">CamelFolder</span></a> object
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>message</code></em> :</span></p></td>
<td> a <a class="link" href="camel-CamelMimeMessage.html#CamelMimeMessage" title="struct CamelMimeMessage"><span class="type">CamelMimeMessage</span></a> object
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>info</code></em> :</span></p></td>
<td> a <a class="link" href="camel-CamelFolderSummary.html#CamelMessageInfo" title="CamelMessageInfo"><span class="type">CamelMessageInfo</span></a> with additional flags/etc to set on
new message, or <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL--CAPS"
><code class="literal">NULL</code></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>appended_uid</code></em> :</span></p></td>
<td> if non-<a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL--CAPS"
><code class="literal">NULL</code></a>, the UID of the appended message will
be returned here, if it is known.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>ex</code></em> :</span></p></td>
<td> a <a class="link" href="camel-camel-exception.html#CamelException" title="struct CamelException"><span class="type">CamelException</span></a>
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" title="camel_folder_has_summary_capability ()">
<a name="camel-folder-has-summary-capability"></a><h3>camel_folder_has_summary_capability ()</h3>
<pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a> camel_folder_has_summary_capability (<a class="link" href="camel-CamelFolder.html#CamelFolder" title="struct CamelFolder">CamelFolder</a> *folder);</pre>
<p>
Get whether or not the folder has a summary.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>folder</code></em> :</span></p></td>
<td> a <a class="link" href="camel-CamelFolder.html#CamelFolder" title="struct CamelFolder"><span class="type">CamelFolder</span></a> object
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE--CAPS"
><code class="literal">TRUE</code></a> if a summary is available or <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE--CAPS"
><code class="literal">FALSE</code></a> otherwise
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" title="camel_folder_get_message_count ()">
<a name="camel-folder-get-message-count"></a><h3>camel_folder_get_message_count ()</h3>
<pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a> camel_folder_get_message_count (<a class="link" href="camel-CamelFolder.html#CamelFolder" title="struct CamelFolder">CamelFolder</a> *folder);</pre>
<p>
</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>folder</code></em> :</span></p></td>
<td> a <a class="link" href="camel-CamelFolder.html#CamelFolder" title="struct CamelFolder"><span class="type">CamelFolder</span></a> object
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> the number of messages in the folder, or <code class="literal">-1</code> if unknown
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" title="camel_folder_get_unread_message_count ()">
<a name="camel-folder-get-unread-message-count"></a><h3>camel_folder_get_unread_message_count ()</h3>
<pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a> camel_folder_get_unread_message_count
(<a class="link" href="camel-CamelFolder.html#CamelFolder" title="struct CamelFolder">CamelFolder</a> *folder);</pre>
<div class="warning" title="Warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">camel_folder_get_unread_message_count</code> is deprecated and should not be used in newly-written code. use <a class="link" href="camel-CamelObject.html#camel-object-get" title="camel_object_get ()"><span class="type">camel_object_get</span></a> instead.</p>
</div>
<p>
</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>folder</code></em> :</span></p></td>
<td> a <a class="link" href="camel-CamelFolder.html#CamelFolder" title="struct CamelFolder"><span class="type">CamelFolder</span></a> object
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> the number of unread messages in the folder, or <code class="literal">-1</code> if
unknown
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" title="camel_folder_get_deleted_message_count ()">
<a name="camel-folder-get-deleted-message-count"></a><h3>camel_folder_get_deleted_message_count ()</h3>
<pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a> camel_folder_get_deleted_message_count
(<a class="link" href="camel-CamelFolder.html#CamelFolder" title="struct CamelFolder">CamelFolder</a> *folder);</pre>
<p>
</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>folder</code></em> :</span></p></td>
<td> a <a class="link" href="camel-CamelFolder.html#CamelFolder" title="struct CamelFolder"><span class="type">CamelFolder</span></a> object
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> the number of deleted messages in the folder, or <code class="literal">-1</code> if
unknown
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" title="camel_folder_get_summary ()">
<a name="camel-folder-get-summary"></a><h3>camel_folder_get_summary ()</h3>
<pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Pointer-Arrays.html#GPtrArray"
>GPtrArray</a> * camel_folder_get_summary (<a class="link" href="camel-CamelFolder.html#CamelFolder" title="struct CamelFolder">CamelFolder</a> *folder);</pre>
<p>
This returns the summary information for the folder. This array
should not be modified, and must be freed with
<a class="link" href="camel-CamelFolder.html#camel-folder-free-summary" title="camel_folder_free_summary ()"><span class="type">camel_folder_free_summary</span></a>.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>folder</code></em> :</span></p></td>
<td> a <a class="link" href="camel-CamelFolder.html#CamelFolder" title="struct CamelFolder"><span class="type">CamelFolder</span></a> object
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> an array of <a class="link" href="camel-CamelFolderSummary.html#CamelMessageInfo" title="CamelMessageInfo"><span class="type">CamelMessageInfo</span></a>
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" title="camel_folder_free_summary ()">
<a name="camel-folder-free-summary"></a><h3>camel_folder_free_summary ()</h3>
<pre class="programlisting">void camel_folder_free_summary (<a class="link" href="camel-CamelFolder.html#CamelFolder" title="struct CamelFolder">CamelFolder</a> *folder,
<a
href="/usr/share/gtk-doc/html/glib/glib-Pointer-Arrays.html#GPtrArray"
>GPtrArray</a> *array);</pre>
<p>
Frees the summary array returned by <a class="link" href="camel-CamelFolder.html#camel-folder-get-summary" title="camel_folder_get_summary ()"><span class="type">camel_folder_get_summary</span></a>.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>folder</code></em> :</span></p></td>
<td> a <a class="link" href="camel-CamelFolder.html#CamelFolder" title="struct CamelFolder"><span class="type">CamelFolder</span></a> object
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>array</code></em> :</span></p></td>
<td> the summary array to free
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" title="camel_folder_get_message ()">
<a name="camel-folder-get-message"></a><h3>camel_folder_get_message ()</h3>
<pre class="programlisting"><a class="link" href="camel-CamelMimeMessage.html#CamelMimeMessage" title="struct CamelMimeMessage">CamelMimeMessage</a> * camel_folder_get_message (<a class="link" href="camel-CamelFolder.html#CamelFolder" title="struct CamelFolder">CamelFolder</a> *folder,
const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *uid,
<a class="link" href="camel-camel-exception.html#CamelException" title="struct CamelException">CamelException</a> *ex);</pre>
<p>
Get a message from its UID in the folder.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>folder</code></em> :</span></p></td>
<td> a <a class="link" href="camel-CamelFolder.html#CamelFolder" title="struct CamelFolder"><span class="type">CamelFolder</span></a> object
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>uid</code></em> :</span></p></td>
<td> the UID
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>ex</code></em> :</span></p></td>
<td> a <a class="link" href="camel-camel-exception.html#CamelException" title="struct CamelException"><span class="type">CamelException</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> a <a class="link" href="camel-CamelMimeMessage.html#CamelMimeMessage" title="struct CamelMimeMessage"><span class="type">CamelMimeMessage</span></a> corresponding to <em class="parameter"><code>uid</code></em>
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" title="camel_folder_sync_message ()">
<a name="camel-folder-sync-message"></a><h3>camel_folder_sync_message ()</h3>
<pre class="programlisting">void camel_folder_sync_message (<a class="link" href="camel-CamelFolder.html#CamelFolder" title="struct CamelFolder">CamelFolder</a> *folder,
const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *uid,
<a class="link" href="camel-camel-exception.html#CamelException" title="struct CamelException">CamelException</a> *ex);</pre>
<p>
Ensure that a message identified by UID has been synced in the folder (so
that camel_folder_get_message on it later will work in offline mode).</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>folder</code></em> :</span></p></td>
<td> a <a class="link" href="camel-CamelFolder.html#CamelFolder" title="struct CamelFolder"><span class="type">CamelFolder</span></a> object
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>uid</code></em> :</span></p></td>
<td> the UID
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>ex</code></em> :</span></p></td>
<td> a <a class="link" href="camel-camel-exception.html#CamelException" title="struct CamelException"><span class="type">CamelException</span></a>
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" title="camel_folder_delete_message()">
<a name="camel-folder-delete-message"></a><h3>camel_folder_delete_message()</h3>
<pre class="programlisting">#define camel_folder_delete_message(folder, uid)</pre>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>folder</code></em> :</span></p></td>
<td>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>uid</code></em> :</span></p></td>
<td>
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" title="camel_folder_get_uids ()">
<a name="camel-folder-get-uids"></a><h3>camel_folder_get_uids ()</h3>
<pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Pointer-Arrays.html#GPtrArray"
>GPtrArray</a> * camel_folder_get_uids (<a class="link" href="camel-CamelFolder.html#CamelFolder" title="struct CamelFolder">CamelFolder</a> *folder);</pre>
<p>
Get the list of UIDs available in a folder. This routine is useful
for finding what messages are available when the folder does not
support summaries. The returned array should not be modified, and
must be freed by passing it to <a class="link" href="camel-CamelFolder.html#camel-folder-free-uids" title="camel_folder_free_uids ()"><span class="type">camel_folder_free_uids</span></a>.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>folder</code></em> :</span></p></td>
<td> a <a class="link" href="camel-CamelFolder.html#CamelFolder" title="struct CamelFolder"><span class="type">CamelFolder</span></a> object
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> a GPtrArray of UIDs corresponding to the messages available
in the folder
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" title="camel_folder_free_uids ()">
<a name="camel-folder-free-uids"></a><h3>camel_folder_free_uids ()</h3>
<pre class="programlisting">void camel_folder_free_uids (<a class="link" href="camel-CamelFolder.html#CamelFolder" title="struct CamelFolder">CamelFolder</a> *folder,
<a
href="/usr/share/gtk-doc/html/glib/glib-Pointer-Arrays.html#GPtrArray"
>GPtrArray</a> *array);</pre>
<p>
Frees the array of UIDs returned by <a class="link" href="camel-CamelFolder.html#camel-folder-get-uids" title="camel_folder_get_uids ()"><span class="type">camel_folder_get_uids</span></a>.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>folder</code></em> :</span></p></td>
<td> a <a class="link" href="camel-CamelFolder.html#CamelFolder" title="struct CamelFolder"><span class="type">CamelFolder</span></a> object
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>array</code></em> :</span></p></td>
<td> the array of uids to free
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" title="camel_folder_get_uncached_uids ()">
<a name="camel-folder-get-uncached-uids"></a><h3>camel_folder_get_uncached_uids ()</h3>
<pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Pointer-Arrays.html#GPtrArray"
>GPtrArray</a> * camel_folder_get_uncached_uids (<a class="link" href="camel-CamelFolder.html#CamelFolder" title="struct CamelFolder">CamelFolder</a> *,
<a
href="/usr/share/gtk-doc/html/glib/glib-Pointer-Arrays.html#GPtrArray"
>GPtrArray</a> *uids,
<a class="link" href="camel-camel-exception.html#CamelException" title="struct CamelException">CamelException</a> *);</pre>
<p>
</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>Param1</code></em> :</span></p></td>
<td>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>uids</code></em> :</span></p></td>
<td> the array of uids to filter down to uncached ones.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>Param3</code></em> :</span></p></td>
<td>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>the known-uncached uids from a list of uids. It may return uids
which are locally cached but should never filter out a uid which is not
locally cached. Free the result by called <a class="link" href="camel-CamelFolder.html#camel-folder-free-uids" title="camel_folder_free_uids ()"><span class="type">camel_folder_free_uids</span></a>.
Frees the array of UIDs returned by <a class="link" href="camel-CamelFolder.html#camel-folder-get-uids" title="camel_folder_get_uids ()"><span class="type">camel_folder_get_uids</span></a>.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" title="camel_folder_cmp_uids ()">
<a name="camel-folder-cmp-uids"></a><h3>camel_folder_cmp_uids ()</h3>
<pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a> camel_folder_cmp_uids (<a class="link" href="camel-CamelFolder.html#CamelFolder" title="struct CamelFolder">CamelFolder</a> *folder,
const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *uid1,
const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *uid2);</pre>
<p>
Compares two uids. The return value meaning is the same as in any other compare function.
</p>
<p>
Note that the default compare function expects a decimal number at the beginning of a uid,
thus if provider uses different uid values, then it should subclass this function.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>folder</code></em> :</span></p></td>
<td> a <a class="link" href="camel-CamelFolder.html#CamelFolder" title="struct CamelFolder"><span class="type">CamelFolder</span></a> object
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>uid1</code></em> :</span></p></td>
<td> The first uid.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>uid2</code></em> :</span></p></td>
<td> the second uid.
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" title="camel_folder_sort_uids ()">
<a name="camel-folder-sort-uids"></a><h3>camel_folder_sort_uids ()</h3>
<pre class="programlisting">void camel_folder_sort_uids (<a class="link" href="camel-CamelFolder.html#CamelFolder" title="struct CamelFolder">CamelFolder</a> *folder,
<a
href="/usr/share/gtk-doc/html/glib/glib-Pointer-Arrays.html#GPtrArray"
>GPtrArray</a> *uids);</pre>
<p>
Sorts the array of UIDs.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>folder</code></em> :</span></p></td>
<td> a <a class="link" href="camel-CamelFolder.html#CamelFolder" title="struct CamelFolder"><span class="type">CamelFolder</span></a> object
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>uids</code></em> :</span></p></td>
<td> array of uids
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" title="camel_folder_has_search_capability ()">
<a name="camel-folder-has-search-capability"></a><h3>camel_folder_has_search_capability ()</h3>
<pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a> camel_folder_has_search_capability (<a class="link" href="camel-CamelFolder.html#CamelFolder" title="struct CamelFolder">CamelFolder</a> *folder);</pre>
<p>
Checks if a folder supports searching.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>folder</code></em> :</span></p></td>
<td> a <a class="link" href="camel-CamelFolder.html#CamelFolder" title="struct CamelFolder"><span class="type">CamelFolder</span></a> object
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE--CAPS"
><code class="literal">TRUE</code></a> if the folder supports searching or <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE--CAPS"
><code class="literal">FALSE</code></a> otherwise
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" title="camel_folder_search_by_expression ()">
<a name="camel-folder-search-by-expression"></a><h3>camel_folder_search_by_expression ()</h3>
<pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Pointer-Arrays.html#GPtrArray"
>GPtrArray</a> * camel_folder_search_by_expression (<a class="link" href="camel-CamelFolder.html#CamelFolder" title="struct CamelFolder">CamelFolder</a> *folder,
const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *expr,
<a class="link" href="camel-camel-exception.html#CamelException" title="struct CamelException">CamelException</a> *ex);</pre>
<p>
Searches the folder for messages matching the given search expression.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>folder</code></em> :</span></p></td>
<td> a <a class="link" href="camel-CamelFolder.html#CamelFolder" title="struct CamelFolder"><span class="type">CamelFolder</span></a> object
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>expr</code></em> :</span></p></td>
<td> a search expression
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>ex</code></em> :</span></p></td>
<td> a <a class="link" href="camel-camel-exception.html#CamelException" title="struct CamelException"><span class="type">CamelException</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> a <a
href="/usr/share/gtk-doc/html/glib/glib-Pointer-Arrays.html#GPtrArray"
><span class="type">GPtrArray</span></a> of uids of matching messages. The caller must
free the list and each of the elements when it is done.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" title="camel_folder_search_by_uids ()">
<a name="camel-folder-search-by-uids"></a><h3>camel_folder_search_by_uids ()</h3>
<pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Pointer-Arrays.html#GPtrArray"
>GPtrArray</a> * camel_folder_search_by_uids (<a class="link" href="camel-CamelFolder.html#CamelFolder" title="struct CamelFolder">CamelFolder</a> *folder,
const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *expr,
<a
href="/usr/share/gtk-doc/html/glib/glib-Pointer-Arrays.html#GPtrArray"
>GPtrArray</a> *uids,
<a class="link" href="camel-camel-exception.html#CamelException" title="struct CamelException">CamelException</a> *ex);</pre>
<p>
Search a subset of uid's for an expression match.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>folder</code></em> :</span></p></td>
<td> a <a class="link" href="camel-CamelFolder.html#CamelFolder" title="struct CamelFolder"><span class="type">CamelFolder</span></a> object
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>expr</code></em> :</span></p></td>
<td> search expression
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>uids</code></em> :</span></p></td>
<td> array of uid's to match against.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>ex</code></em> :</span></p></td>
<td> a <a class="link" href="camel-camel-exception.html#CamelException" title="struct CamelException"><span class="type">CamelException</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> a <a
href="/usr/share/gtk-doc/html/glib/glib-Pointer-Arrays.html#GPtrArray"
><span class="type">GPtrArray</span></a> of uids of matching messages. The caller must
free the list and each of the elements when it is done.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" title="camel_folder_search_free ()">
<a name="camel-folder-search-free"></a><h3>camel_folder_search_free ()</h3>
<pre class="programlisting">void camel_folder_search_free (<a class="link" href="camel-CamelFolder.html#CamelFolder" title="struct CamelFolder">CamelFolder</a> *folder,
<a
href="/usr/share/gtk-doc/html/glib/glib-Pointer-Arrays.html#GPtrArray"
>GPtrArray</a> *result);</pre>
<p>
Free the result of a search as gotten by <span class="type">camel_folder_search</span> or
<a class="link" href="camel-CamelFolder.html#camel-folder-search-by-uids" title="camel_folder_search_by_uids ()"><span class="type">camel_folder_search_by_uids</span></a>.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>folder</code></em> :</span></p></td>
<td> a <a class="link" href="camel-CamelFolder.html#CamelFolder" title="struct CamelFolder"><span class="type">CamelFolder</span></a> object
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>result</code></em> :</span></p></td>
<td> search results to free
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" title="camel_folder_count_by_expression ()">
<a name="camel-folder-count-by-expression"></a><h3>camel_folder_count_by_expression ()</h3>
<pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint32"
>guint32</a> camel_folder_count_by_expression (<a class="link" href="camel-CamelFolder.html#CamelFolder" title="struct CamelFolder">CamelFolder</a> *folder,
const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *expression,
<a class="link" href="camel-camel-exception.html#CamelException" title="struct CamelException">CamelException</a> *ex);</pre>
<p>
Searches the folder for count of messages matching the given search expression.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>folder</code></em> :</span></p></td>
<td> a <a class="link" href="camel-CamelFolder.html#CamelFolder" title="struct CamelFolder"><span class="type">CamelFolder</span></a> object
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>expression</code></em> :</span></p></td>
<td>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>ex</code></em> :</span></p></td>
<td> a <a class="link" href="camel-camel-exception.html#CamelException" title="struct CamelException"><span class="type">CamelException</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> an interger
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" title="camel_folder_get_message_info ()">
<a name="camel-folder-get-message-info"></a><h3>camel_folder_get_message_info ()</h3>
<pre class="programlisting"><a class="link" href="camel-CamelFolderSummary.html#CamelMessageInfo" title="CamelMessageInfo">CamelMessageInfo</a> * camel_folder_get_message_info (<a class="link" href="camel-CamelFolder.html#CamelFolder" title="struct CamelFolder">CamelFolder</a> *folder,
const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *uid);</pre>
<p>
Retrieve the <a class="link" href="camel-CamelFolderSummary.html#CamelMessageInfo" title="CamelMessageInfo"><span class="type">CamelMessageInfo</span></a> for the specified <em class="parameter"><code>uid</code></em>. This return
must be freed using <a class="link" href="camel-CamelFolder.html#camel-folder-free-message-info" title="camel_folder_free_message_info ()"><span class="type">camel_folder_free_message_info</span></a>.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>folder</code></em> :</span></p></td>
<td> a <a class="link" href="camel-CamelFolder.html#CamelFolder" title="struct CamelFolder"><span class="type">CamelFolder</span></a> object
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>uid</code></em> :</span></p></td>
<td> the uid of a message
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> the summary information for the indicated message, or <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL--CAPS"
><code class="literal">NULL</code></a>
if the uid does not exist
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" title="camel_folder_free_message_info ()">
<a name="camel-folder-free-message-info"></a><h3>camel_folder_free_message_info ()</h3>
<pre class="programlisting">void camel_folder_free_message_info (<a class="link" href="camel-CamelFolder.html#CamelFolder" title="struct CamelFolder">CamelFolder</a> *folder,
<a class="link" href="camel-CamelFolderSummary.html#CamelMessageInfo" title="CamelMessageInfo">CamelMessageInfo</a> *info);</pre>
<p>
Free (unref) a <a class="link" href="camel-CamelFolderSummary.html#CamelMessageInfo" title="CamelMessageInfo"><span class="type">CamelMessageInfo</span></a>, previously obtained with
<a class="link" href="camel-CamelFolder.html#camel-folder-get-message-info" title="camel_folder_get_message_info ()"><span class="type">camel_folder_get_message_info</span></a>.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>folder</code></em> :</span></p></td>
<td> a <a class="link" href="camel-CamelFolder.html#CamelFolder" title="struct CamelFolder"><span class="type">CamelFolder</span></a> object
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>info</code></em> :</span></p></td>
<td> a <a class="link" href="camel-CamelFolderSummary.html#CamelMessageInfo" title="CamelMessageInfo"><span class="type">CamelMessageInfo</span></a>
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" title="camel_folder_ref_message_info ()">
<a name="camel-folder-ref-message-info"></a><h3>camel_folder_ref_message_info ()</h3>
<pre class="programlisting">void camel_folder_ref_message_info (<a class="link" href="camel-CamelFolder.html#CamelFolder" title="struct CamelFolder">CamelFolder</a> *folder,
<a class="link" href="camel-CamelFolderSummary.html#CamelMessageInfo" title="CamelMessageInfo">CamelMessageInfo</a> *info);</pre>
<div class="warning" title="Warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">camel_folder_ref_message_info</code> is deprecated and should not be used in newly-written code. Use <a class="link" href="camel-CamelFolderSummary.html#camel-message-info-ref" title="camel_message_info_ref ()"><span class="type">camel_message_info_ref</span></a> directly.
</p>
<p>
Ref a <a class="link" href="camel-CamelFolderSummary.html#CamelMessageInfo" title="CamelMessageInfo"><span class="type">CamelMessageInfo</span></a>, previously obtained with
<a class="link" href="camel-CamelFolder.html#camel-folder-get-message-info" title="camel_folder_get_message_info ()"><span class="type">camel_folder_get_message_info</span></a>.</p>
</div>
<p>
</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>folder</code></em> :</span></p></td>
<td> a <a class="link" href="camel-CamelFolder.html#CamelFolder" title="struct CamelFolder"><span class="type">CamelFolder</span></a> object
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>info</code></em> :</span></p></td>
<td> a <a class="link" href="camel-CamelFolderSummary.html#CamelMessageInfo" title="CamelMessageInfo"><span class="type">CamelMessageInfo</span></a>
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" title="camel_folder_transfer_messages_to ()">
<a name="camel-folder-transfer-messages-to"></a><h3>camel_folder_transfer_messages_to ()</h3>
<pre class="programlisting">void camel_folder_transfer_messages_to (<a class="link" href="camel-CamelFolder.html#CamelFolder" title="struct CamelFolder">CamelFolder</a> *source,
<a
href="/usr/share/gtk-doc/html/glib/glib-Pointer-Arrays.html#GPtrArray"
>GPtrArray</a> *uids,
<a class="link" href="camel-CamelFolder.html#CamelFolder" title="struct CamelFolder">CamelFolder</a> *dest,
<a
href="/usr/share/gtk-doc/html/glib/glib-Pointer-Arrays.html#GPtrArray"
>GPtrArray</a> **transferred_uids,
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a> delete_originals,
<a class="link" href="camel-camel-exception.html#CamelException" title="struct CamelException">CamelException</a> *ex);</pre>
<p>
This copies or moves messages from one folder to another. If the
<em class="parameter"><code>source</code></em> and <em class="parameter"><code>dest</code></em> folders have the same parent_store, this may be
more efficient than using <a class="link" href="camel-CamelFolder.html#camel-folder-append-message" title="camel_folder_append_message ()"><span class="type">camel_folder_append_message</span></a>.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>source</code></em> :</span></p></td>
<td> the source <a class="link" href="camel-CamelFolder.html#CamelFolder" title="struct CamelFolder"><span class="type">CamelFolder</span></a> object
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>uids</code></em> :</span></p></td>
<td> message UIDs in <em class="parameter"><code>source</code></em>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>dest</code></em> :</span></p></td>
<td> the destination <a class="link" href="camel-CamelFolder.html#CamelFolder" title="struct CamelFolder"><span class="type">CamelFolder</span></a> object
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>transferred_uids</code></em> :</span></p></td>
<td> if non-<a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL--CAPS"
><code class="literal">NULL</code></a>, the UIDs of the resulting messages
in <em class="parameter"><code>dest</code></em> will be stored here, if known.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>delete_originals</code></em> :</span></p></td>
<td> whether or not to delete the original messages
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>ex</code></em> :</span></p></td>
<td> a <a class="link" href="camel-camel-exception.html#CamelException" title="struct CamelException"><span class="type">CamelException</span></a>
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" title="camel_folder_delete ()">
<a name="camel-folder-delete"></a><h3>camel_folder_delete ()</h3>
<pre class="programlisting">void camel_folder_delete (<a class="link" href="camel-CamelFolder.html#CamelFolder" title="struct CamelFolder">CamelFolder</a> *folder);</pre>
<p>
Marks a folder object as deleted and performs any required cleanup.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td><p><span class="term"><em class="parameter"><code>folder</code></em> :</span></p></td>
<td> a <a class="link" href="camel-CamelFolder.html#CamelFolder" title="struct CamelFolder"><span class="type">CamelFolder</span></a> object
</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2" title="camel_folder_rename ()">
<a name="camel-folder-rename"></a><h3>camel_folder_rename ()</h3>
<pre class="programlisting">void camel_folder_rename (<a class="link" href="camel-CamelFolder.html#CamelFolder" title="struct CamelFolder">CamelFolder</a> *folder,
const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *new);</pre>
<p>
Mark an active folder object as renamed.
</p>
<p>
NOTE: This is an internal function used by camel stores, no locking
is performed on the folder.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>folder</code></em> :</span></p></td>
<td> a <a class="link" href="camel-CamelFolder.html#CamelFolder" title="struct CamelFolder"><span class="type">CamelFolder</span></a> object
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>new</code></em> :</span></p></td>
<td> new name for the folder
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" title="camel_folder_freeze ()">
<a name="camel-folder-freeze"></a><h3>camel_folder_freeze ()</h3>
<pre class="programlisting">void camel_folder_freeze (<a class="link" href="camel-CamelFolder.html#CamelFolder" title="struct CamelFolder">CamelFolder</a> *folder);</pre>
<p>
Freezes the folder so that a series of operation can be performed
without "folder_changed" signals being emitted. When the folder is
later thawed with <a class="link" href="camel-CamelFolder.html#camel-folder-thaw" title="camel_folder_thaw ()"><span class="type">camel_folder_thaw</span></a>, the suppressed signals will
be emitted.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td><p><span class="term"><em class="parameter"><code>folder</code></em> :</span></p></td>
<td> a <a class="link" href="camel-CamelFolder.html#CamelFolder" title="struct CamelFolder"><span class="type">CamelFolder</span></a>
</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2" title="camel_folder_thaw ()">
<a name="camel-folder-thaw"></a><h3>camel_folder_thaw ()</h3>
<pre class="programlisting">void camel_folder_thaw (<a class="link" href="camel-CamelFolder.html#CamelFolder" title="struct CamelFolder">CamelFolder</a> *folder);</pre>
<p>
Thaws the folder and emits any pending folder_changed
signals.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td><p><span class="term"><em class="parameter"><code>folder</code></em> :</span></p></td>
<td> a <a class="link" href="camel-CamelFolder.html#CamelFolder" title="struct CamelFolder"><span class="type">CamelFolder</span></a> object
</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2" title="camel_folder_is_frozen ()">
<a name="camel-folder-is-frozen"></a><h3>camel_folder_is_frozen ()</h3>
<pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a> camel_folder_is_frozen (<a class="link" href="camel-CamelFolder.html#CamelFolder" title="struct CamelFolder">CamelFolder</a> *folder);</pre>
<p>
</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>folder</code></em> :</span></p></td>
<td> a <a class="link" href="camel-CamelFolder.html#CamelFolder" title="struct CamelFolder"><span class="type">CamelFolder</span></a> object
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> whether or not the folder is frozen
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" title="camel_folder_get_quota_info ()">
<a name="camel-folder-get-quota-info"></a><h3>camel_folder_get_quota_info ()</h3>
<pre class="programlisting"><a class="link" href="camel-CamelFolder.html#CamelFolderQuotaInfo" title="CamelFolderQuotaInfo">CamelFolderQuotaInfo</a> * camel_folder_get_quota_info (<a class="link" href="camel-CamelFolder.html#CamelFolder" title="struct CamelFolder">CamelFolder</a> *folder);</pre>
<p>
</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>folder</code></em> :</span></p></td>
<td> a <a class="link" href="camel-CamelFolder.html#CamelFolder" title="struct CamelFolder"><span class="type">CamelFolder</span></a> object
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> list of known quota(s) for the folder.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" title="camel_folder_quota_info_new ()">
<a name="camel-folder-quota-info-new"></a><h3>camel_folder_quota_info_new ()</h3>
<pre class="programlisting"><a class="link" href="camel-CamelFolder.html#CamelFolderQuotaInfo" title="CamelFolderQuotaInfo">CamelFolderQuotaInfo</a> * camel_folder_quota_info_new (const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *name,
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint64"
>guint64</a> used,
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint64"
>guint64</a> total);</pre>
<p>
</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>name</code></em> :</span></p></td>
<td> Name of the quota.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>used</code></em> :</span></p></td>
<td> Current usage of the quota.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>total</code></em> :</span></p></td>
<td> Total available size of the quota.
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> newly allocated <a class="link" href="camel-CamelFolder.html#CamelFolderQuotaInfo" title="CamelFolderQuotaInfo"><span class="type">CamelFolderQuotaInfo</span></a> structure with
initialized values based on the parameters, with next member set to NULL.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" title="camel_folder_quota_info_clone ()">
<a name="camel-folder-quota-info-clone"></a><h3>camel_folder_quota_info_clone ()</h3>
<pre class="programlisting"><a class="link" href="camel-CamelFolder.html#CamelFolderQuotaInfo" title="CamelFolderQuotaInfo">CamelFolderQuotaInfo</a> * camel_folder_quota_info_clone (const <a class="link" href="camel-CamelFolder.html#CamelFolderQuotaInfo" title="CamelFolderQuotaInfo">CamelFolderQuotaInfo</a> *info);</pre>
<p>
Makes a copy of the given info and all next-s.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>info</code></em> :</span></p></td>
<td> a <a class="link" href="camel-CamelFolder.html#CamelFolderQuotaInfo" title="CamelFolderQuotaInfo"><span class="type">CamelFolderQuotaInfo</span></a> object to clone.
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" title="camel_folder_quota_info_free ()">
<a name="camel-folder-quota-info-free"></a><h3>camel_folder_quota_info_free ()</h3>
<pre class="programlisting">void camel_folder_quota_info_free (<a class="link" href="camel-CamelFolder.html#CamelFolderQuotaInfo" title="CamelFolderQuotaInfo">CamelFolderQuotaInfo</a> *info);</pre>
<p>
Frees this and all next objects.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td><p><span class="term"><em class="parameter"><code>info</code></em> :</span></p></td>
<td> a <a class="link" href="camel-CamelFolder.html#CamelFolderQuotaInfo" title="CamelFolderQuotaInfo"><span class="type">CamelFolderQuotaInfo</span></a> object to free.
</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2" title="camel_folder_free_nop ()">
<a name="camel-folder-free-nop"></a><h3>camel_folder_free_nop ()</h3>
<pre class="programlisting">void camel_folder_free_nop (<a class="link" href="camel-CamelFolder.html#CamelFolder" title="struct CamelFolder">CamelFolder</a> *folder,
<a
href="/usr/share/gtk-doc/html/glib/glib-Pointer-Arrays.html#GPtrArray"
>GPtrArray</a> *array);</pre>
<p>
"Frees" the provided array by doing nothing. Used by <a class="link" href="camel-CamelFolder.html#CamelFolder" title="struct CamelFolder"><span class="type">CamelFolder</span></a>
subclasses as an implementation for free_uids, or free_summary when
the returned array is "static" information and should not be freed.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>folder</code></em> :</span></p></td>
<td> a <a class="link" href="camel-CamelFolder.html#CamelFolder" title="struct CamelFolder"><span class="type">CamelFolder</span></a> object
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>array</code></em> :</span></p></td>
<td> an array of uids or <a class="link" href="camel-CamelFolderSummary.html#CamelMessageInfo" title="CamelMessageInfo"><span class="type">CamelMessageInfo</span></a>
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" title="camel_folder_free_shallow ()">
<a name="camel-folder-free-shallow"></a><h3>camel_folder_free_shallow ()</h3>
<pre class="programlisting">void camel_folder_free_shallow (<a class="link" href="camel-CamelFolder.html#CamelFolder" title="struct CamelFolder">CamelFolder</a> *folder,
<a
href="/usr/share/gtk-doc/html/glib/glib-Pointer-Arrays.html#GPtrArray"
>GPtrArray</a> *array);</pre>
<p>
Frees the provided array but not its contents. Used by <a class="link" href="camel-CamelFolder.html#CamelFolder" title="struct CamelFolder"><span class="type">CamelFolder</span></a>
subclasses as an implementation for free_uids or free_summary when
the returned array needs to be freed but its contents come from
"static" information.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>folder</code></em> :</span></p></td>
<td> a <a class="link" href="camel-CamelFolder.html#CamelFolder" title="struct CamelFolder"><span class="type">CamelFolder</span></a> object
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>array</code></em> :</span></p></td>
<td> an array of uids or <a class="link" href="camel-CamelFolderSummary.html#CamelMessageInfo" title="CamelMessageInfo"><span class="type">CamelMessageInfo</span></a>
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" title="camel_folder_free_deep ()">
<a name="camel-folder-free-deep"></a><h3>camel_folder_free_deep ()</h3>
<pre class="programlisting">void camel_folder_free_deep (<a class="link" href="camel-CamelFolder.html#CamelFolder" title="struct CamelFolder">CamelFolder</a> *folder,
<a
href="/usr/share/gtk-doc/html/glib/glib-Pointer-Arrays.html#GPtrArray"
>GPtrArray</a> *array);</pre>
<p>
Frees the provided array and its contents. Used by <a class="link" href="camel-CamelFolder.html#CamelFolder" title="struct CamelFolder"><span class="type">CamelFolder</span></a>
subclasses as an implementation for free_uids when the provided
information was created explicitly by the corresponding get_ call.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>folder</code></em> :</span></p></td>
<td> a <a class="link" href="camel-CamelFolder.html#CamelFolder" title="struct CamelFolder"><span class="type">CamelFolder</span></a> object
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>array</code></em> :</span></p></td>
<td> an array of uids
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" title="camel_folder_get_filename ()">
<a name="camel-folder-get-filename"></a><h3>camel_folder_get_filename ()</h3>
<pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> * camel_folder_get_filename (<a class="link" href="camel-CamelFolder.html#CamelFolder" title="struct CamelFolder">CamelFolder</a> *folder,
const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *uid,
<a class="link" href="camel-camel-exception.html#CamelException" title="struct CamelException">CamelException</a> *ex);</pre>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>folder</code></em> :</span></p></td>
<td>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>uid</code></em> :</span></p></td>
<td>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>ex</code></em> :</span></p></td>
<td>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" title="camel_folder_change_info_new ()">
<a name="camel-folder-change-info-new"></a><h3>camel_folder_change_info_new ()</h3>
<pre class="programlisting"><a class="link" href="camel-CamelFolder.html#CamelFolderChangeInfo" title="CamelFolderChangeInfo">CamelFolderChangeInfo</a> * camel_folder_change_info_new (void);</pre>
<p>
Create a new folder change info structure.
</p>
<p>
Change info structures are not MT-SAFE and must be
locked for exclusive access externally.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> a new <a class="link" href="camel-CamelFolder.html#CamelFolderChangeInfo" title="CamelFolderChangeInfo"><span class="type">CamelFolderChangeInfo</span></a>
</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2" title="camel_folder_change_info_clear ()">
<a name="camel-folder-change-info-clear"></a><h3>camel_folder_change_info_clear ()</h3>
<pre class="programlisting">void camel_folder_change_info_clear (<a class="link" href="camel-CamelFolder.html#CamelFolderChangeInfo" title="CamelFolderChangeInfo">CamelFolderChangeInfo</a> *info);</pre>
<p>
Empty out the change info; called after changes have been
processed.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td><p><span class="term"><em class="parameter"><code>info</code></em> :</span></p></td>
<td> a <a class="link" href="camel-CamelFolder.html#CamelFolderChangeInfo" title="CamelFolderChangeInfo"><span class="type">CamelFolderChangeInfo</span></a>
</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2" title="camel_folder_change_info_free ()">
<a name="camel-folder-change-info-free"></a><h3>camel_folder_change_info_free ()</h3>
<pre class="programlisting">void camel_folder_change_info_free (<a class="link" href="camel-CamelFolder.html#CamelFolderChangeInfo" title="CamelFolderChangeInfo">CamelFolderChangeInfo</a> *info);</pre>
<p>
Free memory associated with the folder change info lists.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td><p><span class="term"><em class="parameter"><code>info</code></em> :</span></p></td>
<td> a <a class="link" href="camel-CamelFolder.html#CamelFolderChangeInfo" title="CamelFolderChangeInfo"><span class="type">CamelFolderChangeInfo</span></a>
</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2" title="camel_folder_change_info_changed ()">
<a name="camel-folder-change-info-changed"></a><h3>camel_folder_change_info_changed ()</h3>
<pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a> camel_folder_change_info_changed (<a class="link" href="camel-CamelFolder.html#CamelFolderChangeInfo" title="CamelFolderChangeInfo">CamelFolderChangeInfo</a> *info);</pre>
<p>
Gets whether or not there have been any changes.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>info</code></em> :</span></p></td>
<td> a <a class="link" href="camel-CamelFolder.html#CamelFolderChangeInfo" title="CamelFolderChangeInfo"><span class="type">CamelFolderChangeInfo</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE--CAPS"
><code class="literal">TRUE</code></a> if the changeset contains any changes or <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE--CAPS"
><code class="literal">FALSE</code></a>
otherwise
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" title="camel_folder_change_info_add_source ()">
<a name="camel-folder-change-info-add-source"></a><h3>camel_folder_change_info_add_source ()</h3>
<pre class="programlisting">void camel_folder_change_info_add_source (<a class="link" href="camel-CamelFolder.html#CamelFolderChangeInfo" title="CamelFolderChangeInfo">CamelFolderChangeInfo</a> *info,
const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *uid);</pre>
<p>
Add a source uid for generating a changeset.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>info</code></em> :</span></p></td>
<td> a <a class="link" href="camel-CamelFolder.html#CamelFolderChangeInfo" title="CamelFolderChangeInfo"><span class="type">CamelFolderChangeInfo</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>uid</code></em> :</span></p></td>
<td> a uid
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" title="camel_folder_change_info_add_source_list ()">
<a name="camel-folder-change-info-add-source-list"></a><h3>camel_folder_change_info_add_source_list ()</h3>
<pre class="programlisting">void camel_folder_change_info_add_source_list
(<a class="link" href="camel-CamelFolder.html#CamelFolderChangeInfo" title="CamelFolderChangeInfo">CamelFolderChangeInfo</a> *info,
const <a
href="/usr/share/gtk-doc/html/glib/glib-Pointer-Arrays.html#GPtrArray"
>GPtrArray</a> *list);</pre>
<p>
Add a list of source uid's for generating a changeset.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>info</code></em> :</span></p></td>
<td> a <a class="link" href="camel-CamelFolder.html#CamelFolderChangeInfo" title="CamelFolderChangeInfo"><span class="type">CamelFolderChangeInfo</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>list</code></em> :</span></p></td>
<td> a list of uids
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" title="camel_folder_change_info_add_update ()">
<a name="camel-folder-change-info-add-update"></a><h3>camel_folder_change_info_add_update ()</h3>
<pre class="programlisting">void camel_folder_change_info_add_update (<a class="link" href="camel-CamelFolder.html#CamelFolderChangeInfo" title="CamelFolderChangeInfo">CamelFolderChangeInfo</a> *info,
const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *uid);</pre>
<p>
Add a uid from the updated list, used to generate a changeset diff.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>info</code></em> :</span></p></td>
<td> a <a class="link" href="camel-CamelFolder.html#CamelFolderChangeInfo" title="CamelFolderChangeInfo"><span class="type">CamelFolderChangeInfo</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>uid</code></em> :</span></p></td>
<td> a uid
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" title="camel_folder_change_info_add_update_list ()">
<a name="camel-folder-change-info-add-update-list"></a><h3>camel_folder_change_info_add_update_list ()</h3>
<pre class="programlisting">void camel_folder_change_info_add_update_list
(<a class="link" href="camel-CamelFolder.html#CamelFolderChangeInfo" title="CamelFolderChangeInfo">CamelFolderChangeInfo</a> *info,
const <a
href="/usr/share/gtk-doc/html/glib/glib-Pointer-Arrays.html#GPtrArray"
>GPtrArray</a> *list);</pre>
<p>
Add a list of uid's from the updated list.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>info</code></em> :</span></p></td>
<td> a <a class="link" href="camel-CamelFolder.html#CamelFolderChangeInfo" title="CamelFolderChangeInfo"><span class="type">CamelFolderChangeInfo</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>list</code></em> :</span></p></td>
<td> a list of uids
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" title="camel_folder_change_info_build_diff ()">
<a name="camel-folder-change-info-build-diff"></a><h3>camel_folder_change_info_build_diff ()</h3>
<pre class="programlisting">void camel_folder_change_info_build_diff (<a class="link" href="camel-CamelFolder.html#CamelFolderChangeInfo" title="CamelFolderChangeInfo">CamelFolderChangeInfo</a> *info);</pre>
<p>
Compare the source uid set to the updated uid set and generate the
differences into the added and removed lists.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td><p><span class="term"><em class="parameter"><code>info</code></em> :</span></p></td>
<td> a <a class="link" href="camel-CamelFolder.html#CamelFolderChangeInfo" title="CamelFolderChangeInfo"><span class="type">CamelFolderChangeInfo</span></a>
</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2" title="camel_folder_change_info_cat ()">
<a name="camel-folder-change-info-cat"></a><h3>camel_folder_change_info_cat ()</h3>
<pre class="programlisting">void camel_folder_change_info_cat (<a class="link" href="camel-CamelFolder.html#CamelFolderChangeInfo" title="CamelFolderChangeInfo">CamelFolderChangeInfo</a> *info,
<a class="link" href="camel-CamelFolder.html#CamelFolderChangeInfo" title="CamelFolderChangeInfo">CamelFolderChangeInfo</a> *src);</pre>
<p>
Concatenate one change info onto antoher. Can be used to copy them
too.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>info</code></em> :</span></p></td>
<td> a <a class="link" href="camel-CamelFolder.html#CamelFolderChangeInfo" title="CamelFolderChangeInfo"><span class="type">CamelFolderChangeInfo</span></a> to append to
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>src</code></em> :</span></p></td>
<td> a <a class="link" href="camel-CamelFolder.html#CamelFolderChangeInfo" title="CamelFolderChangeInfo"><span class="type">CamelFolderChangeInfo</span></a> to append from
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" title="camel_folder_change_info_add_uid ()">
<a name="camel-folder-change-info-add-uid"></a><h3>camel_folder_change_info_add_uid ()</h3>
<pre class="programlisting">void camel_folder_change_info_add_uid (<a class="link" href="camel-CamelFolder.html#CamelFolderChangeInfo" title="CamelFolderChangeInfo">CamelFolderChangeInfo</a> *info,
const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *uid);</pre>
<p>
Add a new uid to the changeinfo.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>info</code></em> :</span></p></td>
<td> a <a class="link" href="camel-CamelFolder.html#CamelFolderChangeInfo" title="CamelFolderChangeInfo"><span class="type">CamelFolderChangeInfo</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>uid</code></em> :</span></p></td>
<td> a uid
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" title="camel_folder_change_info_remove_uid ()">
<a name="camel-folder-change-info-remove-uid"></a><h3>camel_folder_change_info_remove_uid ()</h3>
<pre class="programlisting">void camel_folder_change_info_remove_uid (<a class="link" href="camel-CamelFolder.html#CamelFolderChangeInfo" title="CamelFolderChangeInfo">CamelFolderChangeInfo</a> *info,
const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *uid);</pre>
<p>
Add a uid to the removed uid list.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>info</code></em> :</span></p></td>
<td> a <a class="link" href="camel-CamelFolder.html#CamelFolderChangeInfo" title="CamelFolderChangeInfo"><span class="type">CamelFolderChangeInfo</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>uid</code></em> :</span></p></td>
<td> a uid
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" title="camel_folder_change_info_change_uid ()">
<a name="camel-folder-change-info-change-uid"></a><h3>camel_folder_change_info_change_uid ()</h3>
<pre class="programlisting">void camel_folder_change_info_change_uid (<a class="link" href="camel-CamelFolder.html#CamelFolderChangeInfo" title="CamelFolderChangeInfo">CamelFolderChangeInfo</a> *info,
const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *uid);</pre>
<p>
Add a uid to the changed uid list.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>info</code></em> :</span></p></td>
<td> a <a class="link" href="camel-CamelFolder.html#CamelFolderChangeInfo" title="CamelFolderChangeInfo"><span class="type">CamelFolderChangeInfo</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>uid</code></em> :</span></p></td>
<td> a uid
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" title="camel_folder_change_info_recent_uid ()">
<a name="camel-folder-change-info-recent-uid"></a><h3>camel_folder_change_info_recent_uid ()</h3>
<pre class="programlisting">void camel_folder_change_info_recent_uid (<a class="link" href="camel-CamelFolder.html#CamelFolderChangeInfo" title="CamelFolderChangeInfo">CamelFolderChangeInfo</a> *info,
const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *uid);</pre>
<p>
Add a recent uid to the changedinfo.
This will also add the uid to the uid_filter array for potential
filtering</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>info</code></em> :</span></p></td>
<td> a <a class="link" href="camel-CamelFolder.html#CamelFolderChangeInfo" title="CamelFolderChangeInfo"><span class="type">CamelFolderChangeInfo</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>uid</code></em> :</span></p></td>
<td> a uid
</td>
</tr>
</tbody>
</table></div>
</div>
</div>
</div>
<div class="footer">
<hr>
Generated by GTK-Doc V1.11</div>
</body>
</html>