Method
CamelFoldertransfer_messages_to
since: 3.0
Declaration [src]
void
camel_folder_transfer_messages_to (
CamelFolder* source,
GPtrArray* message_uids,
CamelFolder* destination,
gboolean delete_originals,
gint io_priority,
GCancellable* cancellable,
GAsyncReadyCallback callback,
gpointer user_data
)
Description [src]
Asynchronously copies or moves messages from one folder to another.
If the source or destination folders have the same parent store,
this may be more efficient than using camel_folder_append_message().
When the operation is finished, callback will be called. You can then call camel_folder_transfer_messages_to_finish() to get the result of the operation.
Available since: 3.0
This method completes asynchronously. Use camel_folder_transfer_messages_to_finish() inside the GAsyncReadyCallback to obtain the result of the operation.
Parameters
message_uids-
Type: An array of
utf8Message UIDs in
source.The data is owned by the caller of the method. Each element is a NUL terminated UTF-8 string. destination-
Type:
CamelFolderThe destination
CamelFolder.The data is owned by the caller of the method. delete_originals-
Type:
gbooleanWhether or not to delete the original messages.
io_priority-
Type:
gintThe I/O priority of the request.
cancellable-
Type:
GCancellableOptional
GCancellableobject, orNULL.The argument can be NULL.The data is owned by the caller of the method. callback-
Type:
GAsyncReadyCallbackA
GAsyncReadyCallbackto call when the request is satisfied.The argument can be NULL. user_data-
Type:
gpointerData to pass to the callback function.
The argument can be NULL.The data is owned by the caller of the method.