Share via


IMAPIViewAdviseSink::OnNewMessage

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 page may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.

Notifies the form viewer that a new or an existing message has been loaded in a form.

HRESULT OnNewMessage( void );

Parameters

None

Return Value

  • S_OK
    The notification succeeded.

Remarks

Form objects call the IMAPIViewAdviseSink::OnNewMessage method whenever a message is loaded in a form using either the IPersistMessage::InitNew or IPersistMessage::Load method.

Notes to Implementers

Release your active pointer to the form object because it no longer points to the message your viewer was formerly viewing.

For more information about form notifications, see Sending and Receiving Form Notifications.

See Also

Reference

IMAPIForm : IUnknown

IPersistMessage::InitNew

IPersistMessage::Load

IMAPIViewAdviseSink : IUnknown