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：

如果窗體查看器在窗體處於任何其他狀態時呼叫 Load ，則方法會傳回 E_UNEXPECTED。

如果您的表單參考的作用中訊息網站不是傳遞至 Load的網站，請釋放原始網站，因為它將不再使用。從 pMessageSite 和 pMessage 參數儲存訊息網站和訊息的指標，並呼叫這兩個物件的 IUnknown：：AddRef 方法來遞增其參考計數。

在 AddRef 完成之後，將 ulMessageStatus 和 ulMessageFlags 參數中的屬性儲存到表單中。在顯示表單之前，將窗體轉換成其 Normal 狀態，並呼叫其 IMAPIViewAdviseSink：：OnNewMessage 方法來通知已註冊的檢視者。

如果未發生任何錯誤，請傳回 S_OK。