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 后台处理程序也可以释放提供程序对象本身。