IMsgStore::StoreLogoff
Hace referencia a: Outlook 2013 | Outlook 2016
Habilita el cierre de sesión ordenado del almacén de mensajes.
HRESULT StoreLogoff(
ULONG FAR * lpulFlags
);
Parameters
lpulFlags
[entrada, salida] Máscara de bits de marcas que controla el cierre de sesión desde el almacén de mensajes. En la entrada, todas las marcas establecidas para este parámetro son mutuamente excluyentes; un autor de la llamada debe especificar solo una marca por llamada. Las siguientes marcas son válidas en la entrada:
LOGOFF_ABORT
Cualquier actividad del proveedor de transporte para este almacén de mensajes se debe detener antes de cerrar la sesión. El control se devuelve al autor de la llamada después de detener la actividad. Si se está produciendo alguna actividad del proveedor de transporte, no se produce el cierre de sesión y no se produce ningún cambio en el comportamiento del colador MAPI o de los proveedores de transporte. Si la actividad del proveedor de transporte está inactiva, la cola MAPI libera el almacén.
LOGOFF_NO_WAIT
El almacén de mensajes no debe esperar a que se cierren los mensajes de los proveedores de transporte. Se envían los mensajes salientes que están listos para enviarse. Si este almacén contiene la Bandeja de entrada predeterminada, se reciben los mensajes en proceso y, a continuación, se deshabilita la recepción adicional. Cuando se completa toda la actividad, la cola MAPI libera el almacén y el control se devuelve inmediatamente al autor de la llamada.
LOGOFF_ORDERLY
El almacén de mensajes no debe esperar la información de los proveedores de transporte antes de cerrarse. Los mensajes que se están procesando actualmente se completan, pero no se procesan nuevos mensajes. Cuando se completa toda la actividad, la cola MAPI libera el almacén y el control se devuelve inmediatamente al proveedor de almacén.
LOGOFF_PURGE
El cierre de sesión debe funcionar igual que si se establece la marca de LOGOFF_NO_WAIT, pero se debe llamar al método IXPLogon::FlushQueues o IMAPIStatus::FlushQueues para los proveedores de transporte adecuados. La marca LOGOFF_PURGE devuelve el control al autor de la llamada después de la finalización.
LOGOFF_QUIET
Si se está produciendo alguna actividad del proveedor de transporte, no debe producirse el cierre de sesión.
Las siguientes marcas son válidas en la salida
LOGOFF_INBOUND
Los mensajes entrantes están llegando actualmente.
LOGOFF_OUTBOUND
Los mensajes salientes están en proceso de envío.
LOGOFF_OUTBOUND_QUEUE
Los mensajes salientes están pendientes (es decir, están en la Bandeja de salida).
Valor devuelto
S_OK
El cierre de sesión se completó correctamente.
Comentarios
El método IMsgStore::StoreLogoff ejerce control sobre la interacción del almacén de mensajes y los proveedores de transporte durante el proceso de cierre de sesión. La llamada a StoreLogoff solo es válida para los almacenes de mensajes que solo usa el autor de la llamada. Por ejemplo, cuando dos clientes usan el mismo almacén de mensajes y uno de ellos llama a StoreLogoff, el almacén de mensajes se libera inmediatamente y el control se devuelve al cliente que realiza la llamada.
Notas a los implementadores
Guarde las marcas que se pasan a StoreLogoff y páselas cuando llame al método IMAPISupport::StoreLogoffTransports . No llames a StoreLogoffTransports hasta que el recuento de referencias del almacén de mensajes baje a cero. Varias llamadas a StoreLogoffTransports simplemente sobrescriben las marcas guardadas.
Si no se ha realizado ninguna llamada a StoreLogoff antes de que el recuento de referencias del almacén de mensajes alcance cero, establezca la marca LOGOFF_ABORT en el parámetro ulFlags que pase a StoreLogoffTransports.