search_header_sync


Description:

[ Version ( since = "3.58" ) ]
public virtual bool search_header_sync (string header_name, GenericArray<string>? words, out GenericArray<unowned string> out_uids, Cancellable? cancellable = null) throws Error

Search the folder for messages with header header_name, which either contains the words or, when the words is empty or null, the header exists in the message.

The list of satisfying message UIDs is returned in the out_uids. The result list can be empty, meaning no such message exists.

Free the returned out_uids with g_ptr_array_unref, when no longer needed.

This is an optional helper method, meant to search server-side. The default implementation returns a G_IO_ERROR_NOT_SUPPORTED error.

Parameters:

this

a Folder

header_name

a header name to search

words

a list of words to search for, or null to check an existence of the header instead

out_uids

a GenericArray of the satisfying message UIDs

cancellable

optional Cancellable object, or null

Returns:

whether could search and set the out_uids.