TransportFreeMsg

This function destroys the MailMsg heap allocated by TransportRecv and resets the heap, header, and message body pointers to NULL.

At a Glance

Header file: Smtp.h
Windows CE versions: 1.0 and later

Syntax

BOOL TransportFreeMessage(MailMsg * MsgPtr);

Parameters

hService

[in] Handle to a SERVICE structure.

Return Values

TRUE indicates success. FALSE indicates that MsgPtr is invalid or that the hHeap member of the specified MailMsg structure does not exist. 

Remarks

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

See Also

TransportRecv