IMAPISession::Logoff
Область применения: Outlook 2013 | Outlook 2016
Завершает сеанс MAPI.
HRESULT Logoff(
ULONG_PTR ulUIParam,
ULONG ulFlags,
ULONG ulReserved
);
Параметры
ulUIParam
[в] Дескриптор родительского окна всех диалоговых окон или окон, которые должны отображаться. Если флаг MAPI_LOGOFF_UI не задан, этот параметр игнорируется.
ulFlags
[в] Битовая маска флагов, управляющих операцией выхода. Можно задать следующие флаги:
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 с пакетом обновления 2 (SP2), Microsoft Outlook 2010, русская версия и Microsoft Outlook 2013, клиенты никогда не должны передавать параметр MAPI_LOGOFF_SHARED в IMAPISession::Logoff. Передача MAPI_LOGOFF_SHARED приведет к завершению работы всех клиентов MAPI и произойдет непредвиденное поведение.