MailPutEx

This function, an extension of MailPut, creates a new mail entry in the message store and operates in a multiple hierarchy folder environment.

At a Glance

Syntax

BOOL MailPutEx (HANDLE hMail, MailMsg*pmm, FID fid);

Parameters

hMail

[in] Handle to the mail context. This handle is created by the MailOpen function.

pmm

[in] Pointer to the MailMsg structure that contains the information for the new entry. This function ignores the dwMsgID member of MailMsg.

fid

[in] Folder identifier of the folder to create the new message in.

Return Values

TRUE indicates success. FALSE indicates failure. To get extended error information, call the function MailError or MailErrorMsg.

Remarks

If this function succeeds, this function sets the oid member of MailMsg with a unique identification number for this mail entry. Other mail functions can use the oid to reference this entry.

This function adds new entries to the message store. To change existing entries, use the MailUpdateEx function.

This function only accepts a MailMsg structure if the pwcHeader and hHeap members are properly initialized with a call to the function MailSetField. The hHeap member must be a handle to a heap you created.

See Also

MailGetEx