HandsOffFromNormal State

Applies to: Outlook 2013 | Outlook 2016

The HandsOffFromNormal state is very similar to the HandsOffAfterSave state. It is part of the process of saving the contents of a form to permanent storage. When in this state, the form object should refrain from making changes to the in-memory copies of values of the message's properties, because there may not be another opportunity to save those changes. The following table describes allowed transitions from the HandsOffFromNormal state.

IPersistMessage method Action New state
IPersistMessage::SaveCompleted(pMessage != NULL)
Replace the message object's message with pMessage, which is the replacement for the message revoked by the previous call to IPersistMessage::HandsOffMessage. The data in the new message is guaranteed to be the same as in the revoked message. The message should not be marked as clean, nor should IMAPIViewAdviseSink::OnSaved be called after this call. If the SaveCompleted call succeeds, enter the Normal state. Otherwise, stay in the HandsOffFromNormal state. Normal or HandsOffFromNormal
IPersistMessage::SaveCompleted(pMessage == NULL)
Set the last error to E_UNEXPECTED. HandsOffFromNormal
HandsOffMessage, IPersistMessage::Save, IPersistMessage::InitNew, or IPersistMessage::Load
Set the last error to E_UNEXPECTED. HandsOffFromNormal
IPersistMessage::GetLastError
Return the last error. HandsOffFromNormal
Other IPersistMessage : IUnknown methods or methods from other interfaces
Set the last error to E_UNEXPECTED. HandsOffFromNormal

See also

Form States