IMAPIProgress::GetMax

Artículo
04/04/2023

Hace referencia a: Outlook 2013 | Outlook 2016

Devuelve el número máximo de elementos de la operación para la que se muestra la información de progreso.

HRESULT GetMax(
  ULONG FAR * lpulMax
);

Parameters

lpulMax

[out] Puntero al número máximo de elementos de la operación.

Valor devuelto

S_OK

Se ha recuperado el número máximo de elementos de la operación.

Comentarios

El valor máximo representa el final de la operación en forma numérica. 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 marca afecta a si el objeto de progreso entiende que el valor máximo es local o global. Cuando se establece la marca de MAPI_TOP_LEVEL, el valor máximo 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áximo se considera local y los proveedores lo usan internamente para mostrar el progreso de los subobjetos de nivel inferior. Los objetos Progress guardan el valor máximo local solo para devolverlo a un proveedor a través de una llamada GetMax .

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.

Notas a los implementadores

Inicialice el valor máximo en 1000. Los proveedores de servicios pueden restablecer este valor llamando al método IMAPIProgress::SetLimits. Para obtener más información sobre cómo implementar GetMax y los otros métodos IMAPIProgress , vea Implementar 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::GetMax	MFCMAPI usa el método IMAPIProgress::GetMax para obtener el valor máximo del objeto de progreso. Devuelve 1000 a menos que se hayan establecido límites previamente con el método IMAPIProgress::SetLimits .