read_message

Reads information about a single message stored in the this.

The message in the out_record is identified by the folder ID and the UID members of the structure.

Call clear on the out_record structure to clear dynamically allocated memory in it.

See also read_messages.

Parameters:

this	a StoreDB
folder_name	a folder name
uid	message UID
out_record	a StoreDBMessageRecord to read the information to

Returns:

whether succeeded