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


IPersistMessage::Save

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

Сохраняет измененную форму обратно в сообщение, из которого она была загружена или создана.

HRESULT Save(
  LPMESSAGE pMessage,
  ULONG fSameAsLoad
);

Параметры

pMessage

[в] Указатель на сообщение.

fSameAsLoad

[в] ЗНАЧЕНИЕ TRUE указывает, что сообщение, на которое указывает pMessage , является сообщением, из которого была загружена или создана форма; в противном случае — FALSE.

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

S_OK

Форма успешно сохранена.

Замечания

Средства просмотра форм вызывают метод IPersistMessage::Save , чтобы сохранить измененную форму обратно в сообщение, из которого она была загружена или создана.

Сохранение должно вызываться только в том случае, если форма находится в обычном состоянии.

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

Не зафиксируйте сохраненные изменения; зафиксировать изменения будет только вызывающий объект. Никогда не изменяйте свойства, принадлежащие сообщению формы, кроме как во время вызова Save .

Если параметр fSameAsLoad имеет значение TRUE, изменения можно сохранить в существующем сообщении формы. Если параметр fSameAsLoad имеет значение FALSE, перед сохранением необходимо скопировать все свойства из исходного сообщения в сообщение, на которое указывает pMessage . Используйте метод IMAPIProp::CopyTo исходного сообщения для копирования свойств.

После копирования всех свойств введите состояние NoScribble . Если ошибок не возникает, верните S_OK. В противном случае верните ошибку из действия, завершилось сбоем.

Если вызывается сохранить , когда форма находится в каком-либо состоянии, отличном от обычного, верните E_UNEXPECTED.

Дополнительные сведения о сохранении объектов хранилища см. в документации по методам IPersistStorage .

См. также

IPersistMessage : IUnknown

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