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 客户端开始关闭,并发生意外行为。