Share via


IFormProviderEx::CreateComposeForm

4/8/2010

The CreateComposeForm method creates a 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 IMessage object to compose.
  • pMsgBase
    [in] Reference to the IMessage to use to pre-fill the form, if one exists.
  • pMsgFields
    [in] Reference to the MESSAGEFIELDS structure for the new message.
  • hwndForm
    [out] Handle of the Compose Message Form's frame.
  • phwndBody
    [out] Reference to the handle belonging to the Compose Message Form's body window.
  • ppForm
    [out] Reference to the newly created Compose Message Form (IMessageFormEx) 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

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

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