IMAPISession::Logoff

适用于:Outlook 2013 | Outlook 2016

结束 MAPI 会话。

HRESULT Logoff(
  ULONG_PTR ulUIParam,
  ULONG ulFlags,
  ULONG ulReserved
);

参数

ulUIParam

[in]要显示的任何对话框或窗口的父窗口的句柄。 如果未设置MAPI_LOGOFF_UI标志,则忽略此参数。

ulFlags

[in]控制注销操作的标志的位掩码。 可以设置以下标志:

MAPI_LOGOFF_SHARED

如果此会话是共享的,则应通知使用共享会话登录的所有客户端正在注销。 客户端应注销。 使用共享会话的任何客户端都可以设置此标志。 如果未共享当前会话,则忽略MAPI_LOGOFF_SHARED。

MAPI_LOGOFF_UI

注销 可以在操作期间显示一个对话框,可能会提示用户进行确认。

ulReserved

[in]保留;必须为零。

返回值

S_OK

注销操作成功。

备注

IMAPISession::Logoff 方法结束 MAPI 会话。 当 Logoff 返回时,除了 IUnknown::Release 之外,任何方法都不能调用。

给调用方的说明

当 Logoff 返回时,通过调用其 IUnknown::Release 方法释放会话对象。

有关结束会话的详细信息,请参阅 结束 MAPI 会话

MFCMAPI 引用

有关 MFCMAPI 示例代码,请参阅下表。

文件 函数 Comment
MAPIObjects.cpp
CMapiObjects::Logoff
MFCMAPI 使用 IMAPISession::Logoff 方法从会话注销,然后再释放会话。

注意

由于 Microsoft Office Outlook 2007 Service Pack 2、Microsoft Outlook 2010 和 Microsoft Outlook 2013 中引入了快速关闭行为,客户端不应将 MAPI_LOGOFF_SHARED 参数传递给 IMAPISession::Logoff。 传递 MAPI_LOGOFF_SHARED 将导致所有 MAPI 客户端开始关闭,并发生意外行为。

另请参阅

IMAPISession : IUnknown

MFCMAPI 代码示例

结束 MAPI 会话