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