IPersistMessage::Load

适用于：Outlook 2013 | Outlook 2016

加载指定邮件的窗体。

HRESULT Load(
  LPMESSAGESITE pMessageSite,
  LPMESSAGE pMessage,
  ULONG ulMessageStatus,
  ULONG ulMessageFlags
);

参数

pMessageSite

[in]指向要加载窗体的消息站点的指针。

pMessage

[in]指向应为其加载窗体的邮件的指针。

ulMessageStatus

[in]客户端定义或提供程序定义的标志的位掩码，从消息的 PR_MSG_STATUS 复制， (PidTagMessageStatus) 属性，提供有关消息状态的信息。

ulMessageFlags

[in]标志的位掩码，从消息的 PR_MESSAGE_FLAGS (PidTagMessageFlags) 属性复制，提供有关消息状态的进一步信息。

S_OK

已成功加载表单。

表单查看者调用 IPersistMessage：：Load 方法来加载现有邮件的表单。

仅当窗体处于以下状态之一时，才会调用加载：

如果窗体查看器在窗体处于任何其他状态时调用 Load ，该方法将返回E_UNEXPECTED。

如果你的表单引用活动邮件网站，而不是传递到 Load 中的网站，请释放原始网站，因为它将不再使用。存储指向消息站点的指针以及 来自 pMessageSite 和 pMessage 参数的消息，并调用这两个对象的 IUnknown：：AddRef 方法来增加其引用计数。

AddRef 完成后，将 ulMessageStatus 和 ulMessageFlags 参数中的属性存储在窗体中。在显示表单之前，将表单转换为正常状态，并通过调用其 IMAPIViewAdviseSink：：OnNewMessage 方法通知已注册的观看者。

如果未发生错误，则返回S_OK。