Поделиться через


IPersistMessage::HandsOffMessage

Область применения: Outlook 2013 | Outlook 2016

Заставляет форму освободить текущее сообщение.

HRESULT HandsOffMessage( void );

Параметры

Нет

Возвращаемое значение

S_OK

Сообщение было успешно освобождено.

Замечания

Формирует переход в два состояния HandsOff:

Если форма находится в любом из этих состояний, она находится в процессе постоянного хранения.

Примечания для исполнителей

Когда средство просмотра формы вызывает метод IPersistMessage::HandsOffMessage , пока форма находится в состоянии Normal или NoScribble , рекурсивно вызовите Метод HandsOffMessage для каждого сообщения, внедренного в текущее сообщение, и метод IPersistStorage::HandsOffStorage для каждого объекта OLE, внедренного в текущее сообщение. Затем отпустите текущее сообщение и все внедренные сообщения и объекты OLE. Если форма находилась в обычном состоянии, перейдите в состояние HandsOffFromNormal. Если форма находилась в состоянии NoScribble, перейдите в состояние HandsOffAfterSave. После успешного перехода вызовите метод IUnknown::Release сообщения и верните S_OK.

Когда средство просмотра формы вызывает HandsOffMessage , когда форма находится в любом из состояний HandsOff, верните E_UNEXPECTED.

Дополнительные сведения о различных состояниях формы см. в разделе Состояния формы. Дополнительные сведения о работе с состоянием HandsOff объектов хранилища см. в статье Метод IPersistStorage::HandsOffStorage .

См. также

IPersistMessage : IUnknown

Состояния формы