IMAPIProviderShutdown : IUnknown
Hace referencia a: Outlook 2013 | Outlook 2016
Permite que el subsistema MAPI informe a un proveedor MAPI del apagado rápido de un cliente MAPI, de modo que el proveedor MAPI pueda responder al apagado.
| Propiedad | Valor |
|---|---|
| Archivo de encabezado: |
Mapidefs.h |
| Expuesto por: |
Objetos de proveedor: IXPProvider, IABProvider o IMSProvider |
| Implementado por: |
Proveedor MAPI |
| Llamado por: |
Subsistema MAPI |
| Identificador de interfaz: |
IID_IMAPIProviderShutdown |
| Tipo de puntero: |
LPMAPIPROVIDERSHUTDOWN |
Orden de tabla virtual
| Propiedad | Valor |
|---|---|
| QueryFastShutdown |
Consulta el proveedor MAPI para obtener compatibilidad con el apagado rápido. |
| NotifyProcessShutdown |
Indica al proveedor MAPI que un cliente MAPI va a realizar un apagado rápido, de modo que el proveedor pueda realizar acciones para evitar la pérdida de datos. |
| DoFastShutdown |
Indica al proveedor MAPI que el cliente MAPI se cierra inmediatamente, de modo que el proveedor MAPI conservará los cambios para evitar la pérdida de datos. |
Comentarios
El apagado rápido permite que un cliente MAPI salga de su proceso en un breve período de tiempo, con suerte después de que el cliente y los proveedores MAPI cargados hayan guardado la configuración mapi y los datos. El cliente MAPI siempre inicia un apagado rápido y debe consultar el subsistema MAPI para obtener compatibilidad con el apagado rápido de los proveedores MAPI cargados. Un administrador puede establecer el Registro de Windows en el nivel de usuario para especificar el nivel de compatibilidad del proveedor necesario para permitir el apagado rápido de todos los clientes MAPI. Para obtener más información sobre la configuración del Registro, vea Opciones de usuario de apagado rápido. Sin embargo, para que el apagado rápido se produzca correctamente sin pérdida de datos, los proveedores MAPI deben implementar la interfaz IMAPIProviderShutdown .
Un proveedor MAPI que necesita admitir el apagado rápido del cliente debe devolver S_OK al subsistema MAPI en el método IMAPIProviderShutdown::QueryFastShutdown . Cuando el subsistema MAPI llama posteriormente a los métodos IMAPIProviderShutdown::NotifyProcessShutdown e IMAPIProviderShutdown::D oFastShutdown , el proveedor MAPI debe realizar las acciones necesarias para guardar la configuración mapi y los datos y prepararse para la salida del cliente.
Los proveedores MAPI que no necesitan admitir el apagado rápido del cliente deben implementar la interfaz IMAPIProviderShutdown y hacer que el método IMAPIProviderShutdown::QueryFastShutdown devuelva MAPI_E_NO_SUPPORT. Para Outlook como cliente MAPI, esto hace que Outlook espere a que se liberen todas las referencias externas antes de salir.
En función de la configuración del Registro de Windows del usuario para el apagado rápido, no implementar la interfaz IMAPIProviderShutdown no impide necesariamente un apagado rápido del cliente.
Para obtener más información sobre el proceso de apagado rápido, consulte Información general sobre el apagado rápido. Para obtener información sobre cómo llevar a cabo el apagado rápido correctamente, consulte Procedimientos recomendados para el apagado rápido.