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を返します。

関連項目

PidTagMessageFlags 標準プロパティ

PidTagMessageStatus 標準プロパティ

IPersistMessage : IUnknown

初期化されていない状態

HandsOffAfterSave 状態

HandsOffFromNormal State

フォームの状態

IPersistStorage::Load

IPersistStream::Load

IPersistFile::Load