IExchExtMessageEvents::OnSubmit

Replaces or enhances the behavior of Microsoft Exchange when a message has been submitted.

Quick Info

See IExchExtMessageEvents : IUnknown.

HRESULT OnSubmit(
  LPEXCHEXTCALLBACK lpeecb  
);

Parameters

lpeecb: [in] Pointer to the IExchExtCallback interface. The lpeecb parameter is used to determine information about the message being submitted and the window whose controls were saved.

Return Values

S_OK: The extension object replaced Microsoft Exchange behavior and handled the submission on its own. Microsoft Exchange will consider the task handled.
S_FALSE: The extension object did nothing or added additional behavior. Microsoft Exchange will continue to call extensions or complete the work itself.

Remarks

Microsoft Exchange calls the IExchExtMessageEvents::OnSubmit method when it is about to submit an open message. At this point, the information will have been written to the message.

If an error occurs, OnSubmit should display an error message and return an error. Microsoft Exchange will not submit the message, nor will it display an error message, but will stop the user action that caused the submit.

This method should call the IExchExtCallback::GetObject method to determine the message identifier of the item being submitted and its container. The container is usually a folder, but it can also be a message or an information store.