Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
4/8/2010

The CreateReadFormmethod creates the read message form for displaying the message.

Syntax 

HRESULT CreateReadForm (
  IMessageFormHostEx * 
pHost,
  LPMESSAGE 
pmsg,
  HWND 
hwndForm,
  HWND * 
phwndBody,
  IMessageFormEx ** 
ppForm
);

Parameters

pHost

[in] Reference to the IMessageFormHostExobject that allows the form to communicate with Messaging.

pmsg

[in] Reference to the message object to show.

hwndForm

[out] Handle of the form frame.

phwndBody

[out] Reference to the handle of the read message form' body window.

ppForm

[out] Reference to the newly created read message form object.

Return Value

This method returns the standard values E_INVALIDARG, E_OUTOFMEMORY, E_UNEXPECTED, and E_FAIL, as well as the following:

S_OK

Indicates success.

Remarks

CreateReadFormis called by Messaging to create the form that is used to display messages for your custom form. The form creates a window as a child of the Messaging window. CreateReadFormreturns handles to the window it has created and a handle to an IMessageFormExinterface. When Messaging calls this method, it passes an IMessageFormHostExpointer that allows the custom form to communicate with the Messaging application.

Requirements

Header cemapi.h
Library cemapi.lib
Windows Embedded CE Windows CE .NET 4.2 and later
Windows Mobile Pocket PC for Windows Mobile 2003 and later, Smartphone for Windows Mobile 2003 and later

See Also

Reference

IFormProviderEx

Other Resources

Messaging