TransportNonIpm

The TransportNonIpm function serves to set non-Inter-Personal Message (non-IPM) properties to a message.

Syntax

BOOL TransportNonIpm (MailMsg * pmm);

At a Glance

Header file:	Smtp.h
Platforms:	H/PC
Windows CE versions:	2.0 and later

Parameters

pmm: Pointer to the mail message to which the non-IPM properties may be written.

Return Values

Returns TRUE if all properties were written (or none needed to be written), FALSE if there was an error.

Remarks

A non-IPM is any message that is processed by an application, rather than read directly by the user. For example, Schedule+ messages are non-IPM messages. An application must interpret the data before the user can read and use them.

Transport DLLs can, but are not required to, expose the TransportNonIpm function. A mail client calls the function to set non-IPM properties for the message which has been downloaded to the message store and whose headers include a "Type" field. To set the non-IPM properties, the transport DLL makes use of the oid field of the MailMsg structure. To save space and overhead, IPM messages should not have a "Type" field set.