IXPLogon::TransportLogoff

适用于:Outlook 2013 | Outlook 2016

启动注销过程。

HRESULT TransportLogoff(
  ULONG ulFlags
);

参数

ulFlags

[in]保留;必须为零。

返回值

S_OK

调用成功并返回了一个或多个预期值。 如果返回除 S_OK 以外的任何内容,则会注销提供程序。

备注

MAPI 后台处理程序调用 IXPLogon::TransportLogoff 方法以终止特定用户的传输提供程序会话。 在调用 TransportLogoff 之前,MAPI 后台处理程序会丢弃 IXPLogon::AddressTypes 方法中传递的此会话支持的消息传送地址类型的任何数据。

针对实现者的说明

传输提供商应准备好随时接受 对 TransportLogoff 的 调用。 如果消息正在处理中,提供程序应停止发送进程。

传输提供程序应释放为其当前会话分配的所有资源。 如果它已使用 MAPIAllocateBuffer 函数为此会话分配了任何内存,则应使用 MAPIFreeBuffer 函数释放内存。 传输提供程序为满足 对 IXPLogon::AddressTypes 方法的调用而分配的任何内存此时都可以安全释放。

通常,在完成 TransportLogoff 调用时,提供程序应首先通过调用 IMAPISupport::MakeInvalid 方法使其登录对象失效,然后释放其支持对象。 提供程序的 TransportLogoff 实现应最后释放支持对象,因为在释放支持对象时,MAPI 后台处理程序也可以释放提供程序对象本身。

另请参阅

IMAPISupport::MakeInvalid

IMAPISupport::SpoolerYield

IXPLogon::AddressTypes

MAPIAllocateBuffer

MAPIFreeBuffer

IXPLogon : IUnknown