TransportNonIpm

This function serves to set non-Interpersonal Message (non-IPM) properties to a message.

At a Glance

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

Syntax

BOOL TransportNonIpm (MailMsg * pmm);

Parameters

pmm

[in] Pointer to the mail message to which the non-IPM properties may be written.

Return Values

TRUE indicates success. FALSE indicates 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 member of the MailMsg structure. To save space and overhead, IPM messages should not have a “Type” field set.