Share via


IMessageFormHost

The IMessageFormHost interface is used in the creation of message forms for both composing and reading. Do not implement this interface. It is exposed by the e-mail application, and you call into it only as necessary.

Note   The IMessageFormHost interface is available only on Windows Mobile 2002. For Windows Mobile 2003 and later, use the IMessageFormHostEx interface.

Methods in Vtable Order

IMessageFormHost methods Description
GetParentHWND Provides a handle to the mail application's parent window.
FormClosing Called by the IMessageForm object when the form is closing.
GetGlobalSetting Gets the value of the global setting from Messaging.
SetGlobalSetting Sets the value of the global setting for Messaging.
DoAction Used to request that Messaging perform a specific action for the plug-in.
CreateNewMessage Creates a new message in the Drafts folder.

Nonvirtual Members

IMessageFormHost members Description
eMsgStatus Enumeration used by IMessageFormHost::FormClosing to indicate how to close a message form.
actions Enumeration used by IMessageFormHost::DoAction to indicate the action for Messaging to perform for a plug-in.

Remarks

Use IMessageFormHost methods when you want your Messaging plug-in to communicate with the Messaging application.

This interface is provided by the Messaging application when it calls IFormProvider::ComposeMessageForm or IFormProvider::CreateReadForm. IMessageFormHost allows the custom form to request that Messaging perform particular actions, such as creating a new message in the drafts folder or handling messages that are not handled by the custom form.

Requirements

Smartphone: Windows Mobile 2002
OS Versions: Windows CE 3.0
Header: cemapi.h
Library: cemapi.lib

See Also

IFormProvider::CreateComposeForm

IFormProvider::CreateReadForm

MAPI Interfaces

Messaging

Last updated on Friday, April 22, 2005

© 2005 Microsoft Corporation. All rights reserved.

Send feedback on this topic to the authors.