TransportDownloadAttachment

This function downloads a specified e-mail attachment.

At a Glance

Syntax

Int TransportDownloadAttachment (HANDLE serviceHandle_p,
MailMsg* mailMessage_p, MailAtt* mailAtt_p)

Parameters

serviceHandle_p

[in] Pointer to a handle to a private SERVICE structure.

mailMessage_p

[in] Pointer to a MailMsg structure that contains information regarding the mail message that has the attached message.

mailApp_p

[in/out] Pointer to a MailApp structure that contains information regarding the attached file. The mailApp_p parameter should contain the index of the attachment specified by uiAttachmentNumber, the handle to a valid heap specified by hHeap , and the service identifier of the mail message specified by szSvcId. This function fills in and returns the rest of mailApp_p.

Return Values

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

Remarks

The transport service provider must implement this function in a DLL registered as a mail service. The Inbox application can then load this DLL and call this function.

When implementing this function, save the attached file in the \Temp directory on the Windows CE platform.