IPersistMessage::Save

适用于:Outlook 2013 | Outlook 2016

将修改后的表单保存回从中加载或创建它的邮件。

HRESULT Save(
  LPMESSAGE pMessage,
  ULONG fSameAsLoad
);

参数

pMessage

[in]指向消息的指针。

fSameAsLoad

[in]如果为 TRUE,则指示 pMessage 指向的消息是从中加载或创建表单的消息;否则为 FALSE。

返回值

S_OK

已成功保存表单。

备注

表单查看者调用 IPersistMessage::Save 方法,将修改后的表单保存回从中加载或创建它的邮件。

仅当窗体处于正常状态时,才应调用保存

针对实现者的说明

不要提交保存的更改;由调用方来提交更改。 切勿更改属于窗体消息的属性,除非在 “保存” 调用期间。

如果 fSameAsLoad 设置为 TRUE,则可以保存对表单现有邮件所做的更改。 如果 fSameAsLoad 设置为 FALSE,则必须在执行保存之前,将原始邮件中的所有属性复制到 pMessage 指向的消息中。 使用原始消息的 IMAPIProp::CopyTo 方法复制属性。

复制所有属性后,输入 NoScribble 状态。 如果未发生错误,则返回S_OK。 否则,返回失败操作中的错误。

如果在窗体处于除 Normal 以外的任何状态时调用 Save ,则返回E_UNEXPECTED。

有关保存存储对象的详细信息,请参阅 有关 IPersistStorage 方法的文档。

另请参阅

IPersistMessage : IUnknown

窗体状态