IMsgStore::FinishedMsg

適用対象: Outlook 2013 | Outlook 2016

メッセージ ストア プロバイダーが送信されたメッセージに対して処理を実行できるようにします。 このメソッドは、MAPI スプーラーによってのみ呼び出されます。

HRESULT FinishedMsg(
  ULONG ulFlags,
  ULONG cbEntryID,
  LPENTRYID lpEntryID
);

パラメーター

ulFlags

[����]�\�񂳂�Ă��܂��B0 �ɂ���K�v������܂��B

cbEntryID

[in] lpEntryID パラメーターによって指されるエントリ識別子のバイト数。

lpEntryID

[in]処理するメッセージのエントリ識別子へのポインター。

戻り値

S_OK

送信されたメッセージの処理に成功しました。

MAPI_E_NO_SUPPORT

メッセージ ストア プロバイダーは、送信されたメッセージ処理をサポートしていません。 呼び出し元が MAPI スプーラーでない場合、このエラー値が返されます。

注釈

IMsgStore::FinishedMsg メソッドは、送信されたメッセージに対して処理を実行します。 この処理には、メッセージの削除、別のフォルダーへの移動、または両方のアクションが含まれる場合があります。 処理の種類は、 PR_DELETE_AFTER_SUBMIT (PidTagDeleteAfterSubmit) プロパティと PR_SENTMAIL_ENTRYID (PidTagSentMailEntryId) プロパティが設定されているかどうかによって異なります。

実装に関するメモ

FinishedMsg の実装で、lpEntryID によって識別されるメッセージのロックを解除し、適切な処理を実行します。 ターゲット メッセージは常にロックされます。MAPI スプーラーは、ロック解除されたメッセージのエントリ識別子を FinishedMsg に渡しません。

PR_DELETE_AFTER_SUBMITPR_SENTMAIL_ENTRYIDも設定されていないか、両方が設定されているか、どちらか一方が設定されている可能性があります。 次の表では、設定に基づいて実行する必要があるアクションについて説明します。

プロパティ
どちらのプロパティも設定されていない場合:
メッセージは、送信元のフォルダー (通常は送信トレイ) のままにします。
両方のプロパティが設定されている場合:
必要に応じて、メッセージを指定されたフォルダーに移動し、削除します。
PR_SENTMAIL_ENTRYIDが設定されている場合:
メッセージを指定されたフォルダーに移動します。
PR_DELETE_AFTER_SUBMITが設定されている場合:
メッセージを削除する。

適切な操作を実行したら、 IMAPISupport::D oSentMail メソッドを 呼び出します。

関連項目

IMAPISupport::DoSentMail

IMsgStore: IMAPIProp