IFormProviderEx::CreateReadForm

4/8/2010

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 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

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

See Also

Reference

IFormProviderEx

Other Resources

Messaging