IMessageFormHostEx::FormClosing

Article
08/28/2006

The FormClosing method is called by the IMessageFormEx interface when the form is closing.

Syntax

HRESULT FormClosing (
  IMessageFormEx * pform,
  IMessage * pMsg,
  CLOSINGMSGSTATUS eMsgStat
);

Parameters

pform
[in] Reference to the IMessageFormEx object.
pMsg
[in] Reference to the IMessage object of the message in the form.
eMsgStat
[out] Status of the message, specified by the CLOSINGMSGSTATUS enumeration.

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

A race condition can occur when the user replies to a message with a custom form. This occurs when the formhost attempts to close the custom form (causing the HWND references to become invalid), and then immediately create another — creating a COM reference count inconsistency that prevents the custom form window from being destroyed. As a workaround, you can save the HWND references in local variables before notifying the host, and then use them with WM_CLOSE and DestroyWindow.

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