Share via


HandsOffFromNormal State

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.

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

Concepts

Form States