IPersistMessage::HandsOffMessage
適用対象: Outlook 2013 | Outlook 2016
フォームの現在のメッセージを解放します。
HRESULT HandsOffMessage( void );
パラメーター
なし
戻り値
S_OK
メッセージが正常に解放されました。
注釈
フォームは 2 つの HandsOff 状態に移行します。
フォームがこれらの状態のいずれかである場合、フォームは永続的に格納される処理中です。
実装に関するメモ
フォーム ビューアーが IPersistMessage::HandsOffMessage メソッドを呼び出し、フォームが Normal または NoScribble 状態の場合は、現在のメッセージに埋め込まれている各メッセージで HandsOffMessage を再帰的に呼び出し、現在のメッセージに埋め込まれている各 OLE オブジェクトの IPersistStorage::HandsOffStorage メソッドを再帰的に呼び出します。 次に、現在のメッセージとすべての埋め込みメッセージと OLE オブジェクトを解放します。 フォームが標準状態の場合は、HandsOffFromNormal 状態に移行します。 フォームが NoScribble 状態の場合は、HandsOffAfterSave 状態に切り替えます。 移行が成功したら、メッセージの IUnknown::Release メソッドを呼び出し、S_OKを返します。
フォームがいずれかの HandsOff 状態にあるときに、フォーム ビューアーが HandsOffMessage を呼び出した場合は、E_UNEXPECTEDを返します。
フォームのさまざまな状態の詳細については、「フォームの 状態」を参照してください。 ストレージ オブジェクトの HandsOff 状態を操作する方法の詳細については、 IPersistStorage::HandsOffStorage メソッドを 参照してください。