Compartir a través de

IMAPIProgress::SetLimits

  • Artículo

Hace referencia a: Outlook 2013 | Outlook 2016

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.

HRESULT SetLimits(
  LPULONG lpulMin,
  LPULONG lpulMax,
  LPULONG lpulFlags
);

Parameters

lpulMin

[in] Puntero a una variable que contiene el límite inferior de elementos de la operación.

lpulMax

[in] Puntero a una variable que contiene el límite superior de elementos de la operación.

lpulFlags

[in] Máscara de bits de marcas que controla el nivel de operación en el que se calcula la información de progreso. Se puede establecer la marca siguiente:

MAPI_TOP_LEVEL

Usa los valores de los parámetros ulCount y ulTotal del método IMAPIProgress::P rogress, que indican el elemento procesado actualmente y el total de elementos, respectivamente, para incrementar el progreso de la operación. Cuando se establece esta marca, se deben establecer los valores de los límites inferior y superior globales.

Valor devuelto

S_OK

La llamada se ha realizado correctamente y devuelva el valor esperado o los valores.

Comentarios

Los proveedores de servicios llaman al método IMAPIProgress::SetLimits para establecer o borrar la marca de MAPI_TOP_LEVEL y establecer valores mínimos y máximos locales y globales. El valor de la configuración de marca afecta a si el objeto de progreso comprende los valores mínimo y máximo para que sean locales o globales. Cuando se establece la marca MAPI_TOP_LEVEL, estos valores se consideran globales y se usan para calcular el progreso de toda la operación. Los objetos Progress inicializan el valor mínimo global en 1 y el valor máximo global en 1000.

Cuando no se establece MAPI_TOP_LEVEL, los valores mínimo y máximo se consideran locales y los proveedores los usan internamente para mostrar el progreso de los subobjetos de nivel inferior. Los objetos Progress solo guardan los valores mínimo y máximo locales para que se puedan devolver a los proveedores cuando se llame a los métodos IMAPIProgress::GetMin e IMAPIProgress::GetMax .

Para obtener más información sobre cómo implementar SetLimits y los 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::SetLimits
 MFCMAPI usa el método IMAPIProgress::SetLimits para establecer los límites y marcas máximos y mínimos para el objeto de progreso.

Vea también

IMAPIProgress::GetMaxIMAPIProgress::GetMin
IMAPIProgress::Progress
IMAPIProgress: IUnknownMFCMAPI como ejemplo de código
Mostrar un indicador de progreso
Implementar un indicador de progreso