IMAPISupport::StoreLogoffTransports
Hace referencia a: Outlook 2013 | Outlook 2016
Solicita la versión ordenada de un almacén de mensajes.
HRESULT StoreLogoffTransports(
ULONG FAR * lpulFlags
);
Parameters
lpulFlags
[entrada, salida] Máscara de bits de marcas que controla cómo se produce el cierre de sesión del almacén de mensajes. En la entrada, todas las marcas de este parámetro son mutuamente excluyentes; solo se puede establecer una de las siguientes marcas por llamada:
LOGOFF_ABORT
Cualquier actividad del proveedor de transporte para este almacén debe detenerse antes de cerrar la sesión. El control se devuelve al cliente después de que se detenga la actividad y la cola MAPI haya cerrado la sesión en el almacén. Si se está produciendo alguna actividad de transporte, no se produce el cierre de sesión y no se produce ningún cambio en el comportamiento del proveedor de transporte o cola MAPI. Si actualmente no hay ninguna actividad, la cola MAPI libera el almacén.
LOGOFF_NO_WAIT
La cola MAPI debe liberar el almacén y devolver el control al cliente inmediatamente después de que se envíe todo el correo saliente que está listo para enviarse. Si el almacén de mensajes tiene la Bandeja de entrada predeterminada, se recibe cualquier mensaje en proceso y, a continuación, se deshabilita la recepción adicional.
LOGOFF_ORDERLY
La cola MAPI debe liberar el almacén y devolver el control al cliente inmediatamente después de que los mensajes pendientes terminen de procesarse. No se debe procesar ningún mensaje nuevo.
LOGOFF_PURGE
Funciona igual que la marca de LOGOFF_NO_WAIT. La marca LOGOFF_PURGE devuelve el control al autor de la llamada después de la finalización.
LOGOFF_QUIET
El cierre de sesión no debe producirse si se está produciendo alguna actividad del proveedor de transporte. El tipo de actividad que tiene lugar se devuelve como una marca en la salida.
En la salida, la cola MAPI puede devolver una o varias de las siguientes marcas:
LOGOFF_COMPLETE
El cierre de sesión puede completarse. Se han liberado todos los recursos asociados al almacén y el objeto se ha invalidado. La cola MAPI ha realizado o realizará todas las solicitudes. En este momento, solo se debe llamar al método IUnknown::Release del almacén de mensajes.
LOGOFF_INBOUND
Un mensaje está llegando actualmente al almacén de uno o varios proveedores de transporte.
LOGOFF_OUTBOUND
Uno o varios proveedores de transporte envían actualmente un mensaje desde el almacén.
LOGOFF_OUTBOUND_QUEUE
Actualmente hay mensajes en la cola de salida para el almacén.
Valor devuelto
S_OK
El procedimiento de cierre de sesión se realizó correctamente.
Comentarios
El método IMAPISupport::StoreLogoffTransports se implementa para los objetos de soporte técnico del proveedor de mensajes. Los proveedores de almacén de mensajes llaman a StoreLogoffTransports para proporcionar a las aplicaciones cliente cierto control sobre cómo mapi controla la actividad del proveedor de transporte mientras se cierra un almacén de mensajes.
Si otro proceso tiene el almacén que se va a cerrar para el mismo perfil, MAPI omite una llamada a StoreLogoffTransports y devuelve la marca LOGOFF_COMPLETE en el parámetro lpulFlags .
El comportamiento del proveedor de almacén después de la devolución de StoreLogoffTransports debe basarse en el valor de lpulFlags, que indica el estado del sistema y transmite las instrucciones del cliente para el comportamiento de cierre de sesión.
Notas para los llamadores
StoreLogoffTransports se suele llamar desde el método IMsgStore::StoreLogoff de un proveedor de almacén. Sin embargo, también se puede llamar desde el método IUnknown::Release del almacén de mensajes. Implemente el método Release del almacén de mensajes para que pueda comprobar si se ha producido o no una llamada a StoreLogoffTransports . Si no se ha producido una llamada, llame a StoreLogoffTransports con la marca LOGOFF_ABORT establecida.
El parámetro lpulFlags se establece en una marca que indica cómo el cliente requiere que se apague el almacén de mensajes. Determine la configuración adecuada para ulFlags en función de la configuración del parámetro correspondiente en la llamada a StoreLogoff. Es decir, si un cliente llama al método StoreLogoff con ulFlags establecido en LOGOFF_ORDERLY, debe llamar a StoreLogoffTransports con ulFlags establecido en LOGOFF_ORDERLY.
Para obtener más información sobre el proceso de cierre de sesión del almacén de mensajes, vea Apagar un proveedor de almacén de mensajes.