IFormProviderEx::CreateComposeForm

Article
08/28/2006

The CreateComposeForm method creates the compose message form.

Syntax

HRESULT CreateComposeForm(
  IMessageFormHostEx * phost,
  LPMESSAGE pmsg,
  FORMTYPE eFormType,
  LPMESSAGE pMsgBase,
  MESSAGEFIELDS * pMsgFields,
  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 compose.
eFormType
[in] The type of form, specified by the FORMTYPE enumeration.
pMsgBase
[in] Reference to the message to prefill the form, if there is one.
pMsgFields
[in] Reference to the message fields for the new message.
hwndForm
[out] Handle of the form frame.
phwndBody
[out] Reference to the handle of the compose message form' body window.
ppForm
[out] Reference to the newly created compose 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

CreateComposeForm is called by Messaging to create the form that is used to create messages for your custom form. The form creates a window as a child of the Messaging window. CreateComposeForm returns a handle 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