typedef void (*ModestAccountProtocolCheckSupportFunc) (ModestAccountProtocol *self,
gboolean supported, gpointer userdata);
+typedef void (*ModestAccountProtocolSaveRemoteDraftCallback) (ModestAccountProtocol *self,
+ GError *error,
+ const gchar *account_id,
+ TnyMsg *new_remote_msg,
+ TnyMsg *new_msg,
+ TnyMsg *old_msg,
+ gpointer userdata);
struct _ModestAccountProtocol {
GObject *object, guint icon_size);
gchar * (*get_service_name) (ModestAccountProtocol *self, const gchar *account_id, const gchar *mailbox);
const GdkPixbuf * (*get_service_icon) (ModestAccountProtocol *self, const gchar *account_id, const gchar *mailbox, guint icon_size);
+ void (*save_remote_draft) (ModestAccountProtocol *self,
+ const gchar *account_id, TnyMsg *new_msg, TnyMsg *old_msg,
+ ModestAccountProtocolSaveRemoteDraftCallback callback,
+ gpointer userdata);
+ void (*cancel_check_support) (ModestAccountProtocol *self);
+ void (*wizard_finished) (ModestAccountProtocol *self);
+ gboolean (*decode_part_to_stream) (ModestAccountProtocol *protocol,
+ TnyMimePart *part,
+ const gchar *stream_uri,
+ TnyStream *stream,
+ gssize *written,
+ GError **error);
+ gboolean (*decode_part_to_stream_async) (ModestAccountProtocol *protocol,
+ TnyMimePart *part,
+ const gchar *stream_uri,
+ TnyStream *stream,
+ TnyMimePartCallback callback,
+ TnyStatusCallback status_callback,
+ gpointer user_data);
/* Padding for future expansions */
- void (*_reserved3) (void);
- void (*_reserved4) (void);
- void (*_reserved5) (void);
- void (*_reserved6) (void);
- void (*_reserved7) (void);
void (*_reserved8) (void);
void (*_reserved9) (void);
void (*_reserved10) (void);
void modest_account_protocol_check_support (ModestAccountProtocol *self,
ModestAccountProtocolCheckSupportFunc func,
gpointer userdata);
+
+/**
+ * modest_account_protocol_cancel_check_support:
+ * @self: a #ModestAccountProtocol
+ *
+ * This method requests that the check support requests running should be
+ * immediately cancelled. Once this happens, is_supported should return %FALSE
+ * until a new succesful check_support request is finished.
+ */
+void modest_account_protocol_cancel_check_support (ModestAccountProtocol *self);
+
+/**
+ * modest_account_protocol_wizard_finished:
+ * @self: a #ModestAccountProtocol
+ *
+ * Method that let protocol know if the wizard has finished, for the case it's
+ * needed to do some stuff after check_support.
+ */
+void modest_account_protocol_wizard_finished (ModestAccountProtocol *self);
+
/**
* modest_account_protocol_is_supported:
* @self: a #ModestAccountProtocol
const gchar *mailbox,
guint icon_size);
+/**
+ * modest_account_protocol_save_remote_draft:
+ * @self: a #ModestAccountProtocol
+ * @account_id: a transport account_name
+ * @new_msg: the newly created message in local storage.
+ * @old_msg: the old message
+ * @callback: the code that should be executed on finishing the remote message saving
+ * @userdata: a #gpointer
+ *
+ * Saves the just-saved to local draft, into a remote storage.
+ */
+void modest_account_protocol_save_remote_draft (ModestAccountProtocol *self,
+ const gchar *account_id,
+ TnyMsg *new_msg,
+ TnyMsg *old_msg,
+ ModestAccountProtocolSaveRemoteDraftCallback callback,
+ gpointer userdata);
+
+/**
+ * modest_account_protocol_decode_part_to_stream:
+ * @self: a #ModestAccountProtocol
+ * @part: a #TnyMimePart
+ * @stream_uri: a string
+ * @stream: a #TnyStream
+ * @written: a #gssize pointer, with the number of bytes written
+ * @error: a #GError
+ *
+ * This virtual method delegates on the account protocol to decode @part
+ * into @stream. It just allows the provider to decode it as it needs
+ * (i.e. when the original message has a fake attachment, and provider
+ * can return the real attachment).
+ *
+ * The @stream_uri parameter tells the uri of the resource @stream is
+ * wrapping (if known).
+ *
+ * Returns: %TRUE if @protocol does the decode operation, %FALSE if modest
+ * should do it.
+ */
+gboolean
+modest_account_protocol_decode_part_to_stream (ModestAccountProtocol *protocol,
+ TnyMimePart *part,
+ const gchar *stream_uri,
+ TnyStream *stream,
+ gssize *written,
+ GError **error);
+
+/**
+ * modest_account_protocol_decode_part_to_stream_async:
+ * @self: a #ModestAccountProtocol
+ * @part: a #TnyMimePart
+ * @stream_uri: a string
+ * @stream: a #TnyStream
+ *
+ * This virtual method delegates on the account protocol to decode @part
+ * into @stream, but asynchronously.
+ *
+ * The @stream_uri parameter tells the uri of the resource @stream is
+ * wrapping (if known).
+ *
+ * Returns: %TRUE if @protocol does the decode operation (then we shouldn't expect
+ * callback to happen from this call, %FALSE if modest should do it.
+ */
+gboolean modest_account_protocol_decode_part_to_stream_async (ModestAccountProtocol *self,
+ TnyMimePart *part,
+ const gchar *stream_uri,
+ TnyStream *stream,
+ TnyMimePartCallback callback,
+ TnyStatusCallback status_callback,
+ gpointer user_data);
+
G_END_DECLS