IXPLogon::EndMessage
適用対象: Outlook 2013 | Outlook 2016
MAPI スプーラーが送信メッセージの処理を完了したことをトランスポート プロバイダーに通知します。
HRESULT EndMessage(
ULONG ulMsgRef,
ULONG FAR * lpulFlags
);
パラメーター
ulMsgRef
[in] IXPLogon::SubmitMessage メソッドの以前の呼び出しで取得されたメッセージ固有の参照値。
lpulFlags
[out]MAPI スプーラーにメッセージで何を行う必要があるかを示すフラグのビットマスク。 フラグが設定されていない場合は、メッセージが送信されています。 次のフラグを設定できます。
END_DONT_RESEND
トランスポート プロバイダーには、このメッセージに関して必要なすべての情報が用意されています。 トランスポート プロバイダーは、より多くの情報を必要とするとき、またはメッセージを送信したときに、NOTIFY_SENTDEFERRED フラグを使用して IMAPISupport::SpoolerNotify メソッドを呼び出し、メッセージのエントリ識別子を渡すことによって MAPI スプーラーに通知します。
END_RESEND_LATER
トランスポート プロバイダーは、エラー条件ではない理由で、現在メッセージを送信していません。 メッセージを送信するには、後でトランスポート プロバイダーを再度呼び出す必要があります。
END_RESEND_NOW
トランスポート プロバイダーは、 IMessage::SubmitMessage メソッド呼び出しで渡されたメッセージを再起動する必要があります。
戻り値
S_OK
呼び出しは成功し、期待される値または値を返しました。
注釈
MAPI スプーラーは、拡張配信または配信不能情報の提供に関連する処理を完了した後、 IXPLogon::EndMessage メソッドを呼び出します。
この呼び出しが戻ると、 ulMsgRef パラメーターの値は、このメッセージに対して有効ではなくなります。 トランスポート プロバイダーは、将来のメッセージで同じ値を再利用できます。
メッセージの転送中にトランスポート プロバイダーが開くすべてのオブジェクトは、MAPI スプーラーがトランスポート プロバイダーに渡すメッセージ オブジェクトを除き、 EndMessage 呼び出しが返される前に解放する必要があります。 MAPI スプーラーによって渡されたメッセージ オブジェクトは、 EndMessage 呼び出しの後に無効です。