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 参数中的值对于此消息不再有效。 传输提供程序可以在将来的消息上重复使用相同的值。

传输提供程序在传输消息期间打开的所有对象都应在 EndMessage 调用返回之前释放,但 MAPI 后台处理程序传递给传输提供程序的消息对象除外。 在 EndMessage 调用后,MAPI 后台处理程序传递的消息对象无效。

另请参阅

IMAPISupport::SpoolerNotify

IMessage::SubmitMessage

IXPLogon::SubmitMessage

IXPLogon : IUnknown