| Camel Reference Manual | ||||
|---|---|---|---|---|
| Top | Description | Object Hierarchy | ||||
#include <camel/camel.h> struct CamelIMAPXStatusResponse; CamelIMAPXStatusResponse * camel_imapx_status_response_new (CamelIMAPXStream *stream,gchar inbox_separator,GCancellable *cancellable,GError **error); const gchar * camel_imapx_status_response_get_mailbox_name (CamelIMAPXStatusResponse *response); gboolean camel_imapx_status_response_get_messages (CamelIMAPXStatusResponse *response,guint32 *out_messages); gboolean camel_imapx_status_response_get_recent (CamelIMAPXStatusResponse *response,guint32 *out_recent); gboolean camel_imapx_status_response_get_unseen (CamelIMAPXStatusResponse *response,guint32 *out_unseen); gboolean camel_imapx_status_response_get_uidnext (CamelIMAPXStatusResponse *response,guint32 *out_uidnext); gboolean camel_imapx_status_response_get_uidvalidity (CamelIMAPXStatusResponse *response,guint32 *out_uidvalidity); gboolean camel_imapx_status_response_get_highestmodseq (CamelIMAPXStatusResponse *response,guint64 *out_highestmodseq);
CamelIMAPXStatusResponse encapsulates an IMAP STATUS response, which describes the current status of a mailbox in terms of various message counts and change tracking indicators.
struct CamelIMAPXStatusResponse;
Contains only private data that should be read and manipulated using the functions below.
Since 3.10
CamelIMAPXStatusResponse * camel_imapx_status_response_new (CamelIMAPXStream *stream,gchar inbox_separator,GCancellable *cancellable,GError **error);
Attempts to parse an IMAP STATUS response from stream and, if successful,
stores the response data in a new CamelIMAPXStatusResponse. If an error
occurs, the function sets error and returns NULL.
|
a CamelIMAPXStream |
|
the separator character for INBOX |
|
a GCancellable |
|
return location for a GError, or NULL
|
Returns : |
a CamelIMAPXStatusResponse, or NULL
|
Since 3.10
const gchar * camel_imapx_status_response_get_mailbox_name
(CamelIMAPXStatusResponse *response);
Returns the mailbox name for response.
|
a CamelIMAPXStatusResponse |
Returns : |
the mailbox name |
Since 3.10
gboolean camel_imapx_status_response_get_messages (CamelIMAPXStatusResponse *response,guint32 *out_messages);
If response includes an updated "MESSAGES" value, write the value to
out_messages and return TRUE. Otherwise leave out_messages unset
and return FALSE.
The "MESSAGES" value refers to the number of messages in the mailbox.
The out_messages argument can be NULL, in which case the function
simply returns whether an updated "MESSAGES" value is present.
|
a CamelIMAPXStatusResponse |
|
return location for the status value, or NULL
|
Returns : |
whether out_messages was set |
Since 3.10
gboolean camel_imapx_status_response_get_recent (CamelIMAPXStatusResponse *response,guint32 *out_recent);
If response includes an updated "RECENT" value, write the value to
out_recent and return TRUE. Otherwise leave out_recent unset and
return FALSE.
The "RECENT" value refers to the number of messages with the \Recent flag set.
The out_recent argument can be NULL, in which case the function
simply returns whether an updated "RECENT" value is present.
|
a CamelIMAPXStatusResponse |
|
return location for the status value, or NULL
|
Returns : |
whether out_recent was set |
Since 3.10
gboolean camel_imapx_status_response_get_unseen (CamelIMAPXStatusResponse *response,guint32 *out_unseen);
If response includes an updated "UNSEEN" value, write the value to
out_unseen and return TRUE. Otherwise leave out_unseen unset and
return FALSE.
The "UNSEEN" value refers to the number of messages which do not have the \Seen flag set.
The out_unseen argument can be NULL, in which case the function
simply returns whether an updated "UNSEEN" value is present.
|
a CamelIMAPXStatusResponse |
|
return location for the status value, or NULL
|
Returns : |
whether out_unseen was set |
Since 3.10
gboolean camel_imapx_status_response_get_uidnext (CamelIMAPXStatusResponse *response,guint32 *out_uidnext);
If response includes an updated "UIDNEXT" value, write the value to
out_uidnext and return TRUE. Otherwise leave out_uidnext unset and
return FALSE.
The "UIDNEXT" value refers to the next unique identifier value of the mailbox.
The out_uidnext argument can be NULL, in which case the function
simply returns whether an updated "UIDNEXT" value is present.
|
a CamelIMAPXStatusResponse |
|
return location for the status value, or NULL
|
Returns : |
whether out_uidnext was set |
Since 3.10
gboolean camel_imapx_status_response_get_uidvalidity (CamelIMAPXStatusResponse *response,guint32 *out_uidvalidity);
If response includes an updated "UIDVALIDITY" value, write the value to
out_uidvalidity and return TRUE. Otherwise leave out_uidvalidity unset
and return FALSE.
The "UIDVALIDITY" value refers to the unique identifier validity of the mailbox.
The out_uidvalidity argument can be NULL, in which case the function
simply returns whether an updated "UIDVALIDITY" value is present.
|
a CamelIMAPXStatusResponse |
|
return location for the status value, or NULL
|
Returns : |
whether out_uidvalidity was set |
Since 3.10
gboolean camel_imapx_status_response_get_highestmodseq (CamelIMAPXStatusResponse *response,guint64 *out_highestmodseq);
If response includes an updated "HIGHESTMODSEQ" value, write the value to
out_highestmodseq and return TRUE. Otherwise leave out_highestmodseq
unset and return FALSE.
The "HIGHESTMODSEQ" value refers to the the highest mod-sequence value of all messages in the mailbox, assuming the server supports the persistent storage of mod-sequences.
The out_highestmodseq argument can be NULL, in which case the function
simply returns whether an updated "HIGHESTMODSEQ" value is present.
|
a CamelIMAPXStatusResponse |
|
return location for the status value, or NULL
|
Returns : |
whether out_highestmodseq was set |
Since 3.10