IFormProviderEx::CreateReadForm

Article
08/28/2006

The CreateReadForm method 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 IMessageFormHostEx object 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 Values

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

CreateReadForm is 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. CreateReadForm returns handles to the window it has created and a handle to an IMessageFormEx interface. When Messaging calls this method, it passes an IMessageFormHostEx pointer that allows the custom form to communicate with the Messaging application.

Requirements

Pocket PC: Windows Mobile 2003 and later
Smartphone: Windows Mobile 2003 and later
OS Versions: Windows CE .NET 4.2 and later
Header: cemapi.h
Library: cemapi.lib

Share via