MailUpdate

The MailUpdate function replaces an entry in the message store with updated information.

Syntax

BOOL MailUpdate (HANDLE hMail, MailMsg* pmm, BOOL fDoAll);

At a Glance

Header file:	Msgstore.h
Platforms:	H/PC
Versions:	1.0 and later

Parameters

hMail: Handle to the mail context. This handle is created by the MailOpen function.
pmm: Pointer to the MailMsg structure containing the mail entry with the updated information.
fDoAll: If this parameter is TRUE, all members of the MailMsg structure are updated; if FALSE, only the flags are changed — that is, the dwFlags field in the MailMsg structure pointed to by pmm.

Return Values

This function returns TRUE if successful; FALSE if it fails. To get extended error information, use MailError or MailErrorMsg.

Remarks

The entry being updated is based on the oid member of the MailMsg structure. If the entry does not exist in the database, the MailUpdate function fails.