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 后台处理程序传递的消息对象无效。