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.
- eFormType
[in] The type of form, specified by the IFormProviderEx::FORMTYPE enumeration.
- 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 |