IMAPISession::Logoff
Hace referencia a: Outlook 2013 | Outlook 2016
Finaliza una sesión MAPI.
HRESULT Logoff(
ULONG_PTR ulUIParam,
ULONG ulFlags,
ULONG ulReserved
);
Parameters
ulUIParam
[in] Identificador de la ventana primaria de los cuadros de diálogo o ventanas que se van a mostrar. Este parámetro se omite si no se establece la marca de MAPI_LOGOFF_UI.
ulFlags
[in] Máscara de bits de marcas que controlan la operación de cierre de sesión. Se pueden establecer las siguientes marcas:
MAPI_LOGOFF_SHARED
Si esta sesión se comparte, todos los clientes que iniciaron sesión mediante la sesión compartida deben recibir una notificación del cierre de sesión en curso. Los clientes deben cerrar la sesión. Cualquier cliente que use la sesión compartida puede establecer esta marca. MAPI_LOGOFF_SHARED se omite si no se comparte la sesión actual.
MAPI_LOGOFF_UI
Cerrar sesión puede mostrar un cuadro de diálogo durante la operación, posiblemente solicitando confirmación al usuario.
ulReserved
[entrada] Reservado; debe ser cero.
Valor devuelto
S_OK
La operación de cierre de sesión se realizó correctamente.
Comentarios
El método IMAPISession::Logoff finaliza una sesión MAPI. Cuando se devuelve Logoff , no se puede llamar a ninguno de los métodos excepto IUnknown::Release .
Notas para los llamadores
Cuando se devuelve Logoff , libere el objeto de sesión llamando a su método IUnknown::Release .
Para obtener más información sobre cómo finalizar una sesión, vea Finalización de una sesión MAPI.
Referencia de MFCMAPI
Para obtener un ejemplo de código de MFCMAPI, vea la siguiente tabla.
| Archivo | Función | Comment |
|---|---|---|
| MAPIObjects.cpp |
CMapiObjects::Logoff |
MFCMAPI usa el método IMAPISession::Logoff para cerrar la sesión antes de liberarla. |
Nota:
Debido al comportamiento de apagado rápido introducido en Microsoft Office Outlook 2007 Service Pack 2, Microsoft Outlook 2010 y Microsoft Outlook 2013, los clientes nunca deben pasar el parámetro MAPI_LOGOFF_SHARED a IMAPISession::Logoff. Pasar MAPI_LOGOFF_SHARED hará que todos los clientes MAPI comiencen a apagarse y se producirá un comportamiento inesperado.