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.
4/8/2010

The OnMessageModifiedmethod notifies the message form when a message object changes.

Syntax 

HRESULT OnMessageModified (
  ULONG 
cbId,
  LPENTRYID 
pid,
  LPSPropTagArray 
props
);

Parameters

cbId

[in] Count of bytes pointed to by the pidpointer.

pid

[in] Reference to the entry ID of the message object changed.

props

[out] Reference to an SPropTagArraystructure that contains the properties that changed.

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

For performance reasons, OnMessageModifiedshould do something only if the message that changed is the one that the form is displaying. OnMessageModifiedcan also inspect the SpropTagArraystructure to determine whether any of the properties in question have changed.

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

IMessageFormEx

Other Resources

Messaging