IMAPIProgress : IUnknown
Hace referencia a: Outlook 2013 | Outlook 2016
Implementa un objeto de progreso que proporciona a las aplicaciones cliente un indicador de progreso. Un indicador de progreso es una pantalla de interfaz de usuario que muestra el porcentaje de finalización de una operación, como copiar carpetas entre almacenes de mensajes. Las aplicaciones cliente y MAPI implementan objetos de progreso y los proveedores de servicios los usan.
| Propiedad | Valor |
|---|---|
| Archivo de encabezado: |
Mapidefs.h |
| Expuesto por: |
Objetos de progreso |
| Implementado por: |
Aplicaciones MAPI y cliente |
| Llamado por: |
Proveedores de servicios |
| Identificador de interfaz: |
IID_IMAPIProgress |
| Tipo de puntero: |
LPMAPIPROGRESS |
Orden de tabla virtual
| Member | Descripción |
|---|---|
|
Progress |
Novedades el indicador de progreso con una visualización del progreso a medida que se realiza hacia la finalización de la operación. |
|
GetFlags |
Devuelve la configuración de marca del objeto de progreso para el nivel de operación en el que se calcula la información de progreso. |
|
GetMax |
Devuelve el número máximo de elementos de la operación para la que se muestra la información de progreso. |
|
GetMin |
Devuelve el valor mínimo del método SetLimits para el que se muestra información de progreso. |
|
SetLimits |
Establece los límites inferior y superior para el número de elementos de la operación y las marcas que controlan cómo se calcula la información de progreso para la operación. |
Comentarios
MAPI incluye un parámetro lpProgress en muchos de los métodos que realizan operaciones potencialmente largas. lpProgress apunta a una implementación de cliente de un objeto de progreso. Los clientes que implementan la interfaz IMAPIProgress establecen este parámetro para que apunte a su implementación; Los clientes que no implementan IMAPIProgress establecen el parámetro en NULL. Para mostrar un indicador de progreso durante el procesamiento de la operación, los proveedores de servicios usan el objeto de progreso proporcionado por el cliente, si está disponible, o una implementación MAPI (se indica cuando lpProgress está establecido en NULL).
Referencia de MFCMAPI
Para obtener un ejemplo de código de MFCMAPI, vea la siguiente tabla.
| Files | Función | Comment |
|---|---|---|
| MapiProgress.h y MapiProgress.cpp |
No aplicable |
Si la configuración IMAPIProgress está habilitada, MFCMAPI pasará una implementación IMAPIProgress a todas las funciones que MFCMAPI invoca que aceptan una implementación. |