Compartilhar via

IMAPIProgress::SetLimits

  • Artigo

Aplica-se a: Outlook 2013 | Outlook 2016

Define os limites inferior e superior para o número de itens na operação e os sinalizadores que controlam como as informações de progresso são calculadas para a operação.

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

Parâmetros

lpulMin

[in] Um ponteiro para uma variável que contém o limite inferior de itens na operação.

lpulMax

[in] Um ponteiro para uma variável que contém o limite superior de itens na operação.

lpulFlags

[in] Um bitmask de sinalizadores que controla o nível de operação no qual as informações de progresso são calculadas. O seguinte sinalizador pode ser definido:

MAPI_TOP_LEVEL

Usa os valores nos parâmetros ulCount e ulTotal do método IMAPIProgress::P rogress, que indicam o item processado atualmente e o total de itens, respectivamente, para incrementar o progresso na operação. Quando esse sinalizador é definido, os valores dos limites inferiores e superiores globais devem ser definidos.

Valor de retorno

S_OK

A chamada foi bem-sucedida e retornou o valor ou valores esperados.

Comentários

Os provedores de serviços chamam o método IMAPIProgress::SetLimits para definir ou limpar o sinalizador MAPI_TOP_LEVEL e definir valores mínimos e máximos locais e globais. O valor da configuração do sinalizador afeta se o objeto de progresso entende os valores mínimos e máximos a serem locais ou globais. Quando o sinalizador MAPI_TOP_LEVEL é definido, esses valores são considerados globais e são usados para calcular o progresso de toda a operação. Objetos de progresso inicializam o valor mínimo global para 1 e o valor máximo global para 1000.

Quando MAPI_TOP_LEVEL não é definido, os valores mínimos e máximos são considerados locais e os provedores os usam internamente para exibir progresso para subobjetos de nível inferior. Os objetos de progresso salvam os valores mínimos e máximos locais apenas para que possam ser retornados aos provedores quando os métodos IMAPIProgress::GetMin e IMAPIProgress::GetMax forem chamados.

Para obter mais informações sobre como implementar SetLimits e os outros métodos IMAPIProgress , consulte Implementando um Indicador de Progresso.

Para saber mais sobre como e quando fazer chamadas para um objeto de progresso, confira o tópico Exibir um indicador de progresso.

Referência do MFCMAPI

Para ver códigos de exemplo do MFCMAPI, confira a tabela a seguir.

Arquivo Função Comentário
MAPIProgress.cpp
 CMAPIProgress::SetLimits
 O MFCMAPI usa o método IMAPIProgress::SetLimits para definir os limites e sinalizadores máximos e mínimos para o objeto de progresso.

Confira também

IMAPIProgress::GetMaxIMAPIProgress::GetMin
IMAPIProgress::Progress
IMAPIProgress : IUnknownMFCMAPI como exemplo de código
Exibir um indicador de progresso
Como implementar um indicador de progresso