IMAPIProgress::GetMin

Artículo
04/04/2023

Hace referencia a: Outlook 2013 | Outlook 2016

Devuelve el valor mínimo del método IMAPIProgress::SetLimits para el que se muestra información de progreso.

HRESULT GetMin(
  ULONG FAR * lpulMin
);

Parámetros

lpulMin

[salida] Un puntero al número mínimo de elementos de la operación.

Valor devuelto

S_OK

El número mínimo de elementos de la operación que se ha recuperado.

Comentarios

El valor mínimo representa el inicio de la operación en formato numérico. El valor puede ser un valor máximo global, usado para representar el ámbito de la pantalla de progreso total, o un valor local, para representar únicamente una parte de la pantalla.

El valor de la configuración de la etiqueta determina si el objeto de progreso comprende el valor mínimo local o global. Cuando se establece la etiqueta MAPI_TOP_LEVEL, el valor mínimo se considera global y se usa para calcular el progreso de toda la operación. Cuando no se establece MAPI_TOP_LEVEL, el valor mínimo se considera local y los proveedores lo usan internamente para mostrar el progreso de objetos secundarios de nivel inferior. Los objetos de progreso guardan el valor mínimo local solo para devolverlo a un proveedor a través de una llamada GetMin.

Notas a los implementadores

Inicialice el valor mínimo en 1. Los proveedores de servicios pueden restablecer este valor llamando al método IMAPIProgress::SetLimits. Para obtener más información sobre cómo implementar GetMin y otros métodos IMAPIProgress, vea Implementar un indicador de progreso.

Para obtener más información sobre cómo y cuándo debe realizar llamadas a un objeto de progreso, vea Mostrar un indicador de progreso.

Referencia de MFCMAPI

Para obtener un ejemplo de código de MFCMAPI, vea la siguiente tabla.

Archivo	Función	Comentario
MAPIProgress.cpp	CMAPIProgress::GetMin	MFCMAPI usa el método IMAPIProgress::GetMin para obtener el valor mínimo para el indicador de progreso. Devuelve el valor 1 a menos que se hayan establecido límites anteriormente llamando al método IMAPIProgress::SetLimits.