da_notmuch_database_remove_message

Remove a message filename from the given notmuch database. If the message has no more filenames, remove the message.

If the same message (as determined by the message ID) is still available via other filenames, then the message will persist in the database for those filenames. When the last filename is removed for a particular message, the database content for that message will be entirely removed.

Return value:

alias da_notmuch_database_remove_message = notmuch_status_t function()

Detailed Description

NOTMUCH STATUS SUCCESS

The last filename was removed and the * message was removed from the database.

NOTMUCH STATUS XAPIAN EXCEPTION

A Xapian exception occurred, * message not removed.

NOTMUCH STATUS DUPLICATE MESSAGE ID

This filename was removed but * the message persists in the database with at least one other * filename.

NOTMUCH STATUS READ ONLY DATABASE

Database was opened in read-only * mode so no message can be removed.

NOTMUCH STATUS UPGRADE REQUIRED

The caller must upgrade the database to use this function.

Meta