Important: |
---|
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist. |
The FormClosingmethod is called by the IMessageFormExinterface when the form is closing.
Syntax
HRESULT FormClosing ( IMessageFormEx * pform, IMessage * pMsg, CLOSINGMSGSTATUS eMsgStat ); |
Parameters
- pform
-
[in] Reference to the IMessageFormExobject.
- pMsg
-
[in] Reference to the IMessageobject of the message in the form.
- eMsgStat
-
[out] Status of the message, specified by the CLOSINGMSGSTATUSenumeration.
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
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_CLOSEand DestroyWindow.
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
IMessageFormExIMessageFormHostEx
IMessageFormHostEx::CLOSINGMSGSTATUS