IMAPIMessageSite::DeleteMessageIMAPIMessageSite::DeleteMessage

適用されます: OutlookApplies to: Outlook

現在のメッセージを削除します。Deletes the current message.

HRESULT DeleteMessage(
  LPMAPIVIEWCONTEXT pViewContext,
  LPCRECT prcPosRect
);

ParametersParameters

pViewContextpViewContext

[in]ビュー コンテキスト オブジェクトへのポインター。[in] A pointer to a view context object.

prcPosRectprcPosRect

[in]現在のフォームのウィンドウのサイズと位置を含むRECT構造体へのポインター。[in] A pointer to a RECT structure that contains the current form's window size and position. 次に表示されるフォームは、このウィンドウの四角形にも使用します。The next form displayed also uses this window rectangle.

�߂�lReturn value

S_OKS_OK

�ʘb���������A�\�������l�܂��͒l���Ԃ���܂��BThe call succeeded and has returned the expected value or values.

MAPI_E_NO_SUPPORTMAPI_E_NO_SUPPORT

このメッセージのサイトでは、操作はサポートされていません。The operation is not supported by this message site.

備考Remarks

フォーム オブジェクトは、フォームが現在表示されているメッセージを削除するのにはIMAPIMessageSite::DeleteMessageメソッドを呼び出します。A form object calls the IMAPIMessageSite::DeleteMessage method to delete the message that the form is currently displaying.

呼び出し側への注意Notes to callers

DeleteMessageの戻り値は、次のフォーム オブジェクトが新しいメッセージを確認し、存在しない場合はそれ自体を終了してください。Following the return of DeleteMessage, form objects must check for a new message and then dismiss themselves if none exists. DeleteMessageの処理でメッセージが削除またはを削除済みアイテムフォルダーに移動するかどうかを確認するのにフォーム オブジェクトは、DELETE_IS_MOVE フラグが返されたかどうかを決定するIMAPIMessageSite::GetSiteStatusメソッドを呼び出すことができます。To determine whether the message DeleteMessage acted on was deleted or moved to a Deleted Items folder, a form object can call the IMAPIMessageSite::GetSiteStatus method to determine whether the DELETE_IS_MOVE flag was returned.

実装者へのメモNotes to implementers

DeleteMessageメソッドの実装をフォームのビューアーの移動する場合、次のメッセージのメッセージを削除した後、実装する必要がありますIMAPIViewContext::ActivateNextメソッドを呼び出すし、実行する前に VCDIR_DELETE フラグを渡す実際の削除します。If a form viewer's implementation of the DeleteMessage method moves to the next message after it deletes a message, the implementation should call the IMAPIViewContext::ActivateNext method and pass the VCDIR_DELETE flag before performing the actual deletion. DeleteMessageフォーム ビューアーの実装では、(たとえば、 [削除済みアイテムフォルダー) に削除されたメッセージを移動した場合実装は、メッセージが変更された場合は、メッセージに変更を保存する必要があります。If a form viewer's implementation of DeleteMessage moves the deleted message (for example, to a Deleted Items folder), the implementation must save changes to the message if the message was modified.

DeleteMessageの一般的な実装では、次のタスクを実行します。A typical implementation of DeleteMessage performs the following tasks:

  1. 実装では、メッセージを移動では場合、は、 null _pMessage_パラメーターとの場合は true 、 _fSameAsLoad_パラメーターに渡して、 IPersistMessage::Saveメソッドを呼び出します。If the implementation is moving the message, it calls the IPersistMessage::Save method, passing null in the pMessage parameter and true in the fSameAsLoad parameter.

  2. _UlDir_パラメーターに VCDIR_DELETE フラグを渡す、 IMAPIViewContext::ActivateNextメソッドを呼び出します。It calls the IMAPIViewContext::ActivateNext method, passing the VCDIR_DELETE flag in the ulDir parameter.

  3. ActivateNextの呼び出しが失敗したかどうかを返します。If the ActivateNext call fails, it returns. ActivateNextが S_FALSE を返す場合は、 IPersistMessage::HandsOffMessageメソッドを呼び出します。If ActivateNext returns S_FALSE, it calls the IPersistMessage::HandsOffMessage method.

  4. 削除または、メッセージを移動します。It deletes or moves the message.

フォームのウィンドウで使用されているRECT構造体を取得するには、Windowsハンドル関数を呼び出します。To obtain the RECT structure used by a form's window, call the Windows GetWindowRect function.

フォームのサーバーに関連するインターフェイスの一覧は、 MAPI フォームのインタ フェースを参照してください。For a list of interfaces related to form servers, see MAPI Form Interfaces.

MFCMAPI 参照MFCMAPI reference

MFCMAPI �T���v�� �R�[�h�ł́A���̕\��Q�Ƃ��Ă��������BFor MFCMAPI sample code, see the following table.

�t�@�C��File �֐�Function �R�����gComment
MyMAPIFormViewer.cppMyMAPIFormViewer.cpp
CMyMAPIFormViewer::DeleteMessageCMyMAPIFormViewer::DeleteMessage
実装されていません。Not implemented.

関連項目See also

IMAPIMessageSite::GetSiteStatusIMAPIMessageSite::GetSiteStatus

IMAPIViewContext::ActivateNextIMAPIViewContext::ActivateNext

IPersistMessage::HandsOffMessageIPersistMessage::HandsOffMessage

IPersistMessage::SaveIPersistMessage::Save

IMAPIMessageSite: IUnknownIMAPIMessageSite : IUnknown

[�R��h �T���v���Ƃ��� MFCMAPIMFCMAPI as a Code Sample

MAPI フォームのインタ フェースMAPI Form Interfaces