IPersistMessage::Save

  • [アーティクル]

適用対象: Outlook 2013 | Outlook 2016

変更されたフォームを、読み込み元または作成元のメッセージに保存します。

HRESULT Save(
  LPMESSAGE pMessage,
  ULONG fSameAsLoad
);

パラメーター

pMessage

[in]メッセージへのポインター。

fSameAsLoad

[in] pMessage が指すメッセージが、フォームの読み込み元または作成元のメッセージであることを示す場合は TRUE。それ以外の場合は FALSE。

戻り値

S_OK

フォームが正常に保存されました。

注釈

フォーム ビューアーは IPersistMessage::Save メソッドを呼び出して、変更されたフォームを読み込まれたメッセージまたは作成元のメッセージに保存します。

保存 は、フォームが 標準 状態の場合にのみ呼び出す必要があります。

実装に関するメモ

保存した変更はコミットしないでください。変更をコミットするのは呼び出し元次第です。 Save 呼び出し中を除き、フォームのメッセージに属するプロパティを変更しないでください。

fSameAsLoad が TRUE に設定されている場合は、フォームの既存のメッセージに変更を保存できます。 fSameAsLoad が FALSE に設定されている場合は、保存を実行する前に、元のメッセージから pMessage が指すメッセージにすべてのプロパティをコピーする必要があります。 元のメッセージの IMAPIProp::CopyTo メソッドを使用して、プロパティをコピーします。

すべてのプロパティがコピーされたら、 NoScribble 状態を入力します。 エラーが発生しない場合は、S_OKを返します。 それ以外の場合は、失敗したアクションからエラーを返します。

フォームが Normal 以外の状態のときに Save が呼び出された場合は、E_UNEXPECTEDを返します。

ストレージ オブジェクトの保存の詳細については、 IPersistStorage メソッドに関するドキュメントを参照してください。

関連項目

IPersistMessage : IUnknown

フォームの状態