IMAPIProgress::GetMax

Aplica-se a: Outlook 2013 | Outlook 2016

Retorna o número máximo de itens na operação para a qual as informações de progresso são exibidas.

HRESULT GetMax(
  ULONG FAR * lpulMax
);

Parâmetros

lpulMax

[out] Um ponteiro para o número máximo de itens na operação.

Valor de retorno

S_OK

O número máximo de itens na operação foi recuperado.

Comentários

O valor máximo representa o fim da operação no formulário numérico. O valor pode ser um valor máximo global, usado para representar o escopo de toda a exibição do progresso, ou um valor local, usado para representar apenas uma parte da exibição.

O valor da configuração do sinalizador afeta se o objeto de progresso entende o valor máximo para ser local ou global. Quando o sinalizador MAPI_TOP_LEVEL é definido, o valor máximo é considerado global e é usado para calcular o progresso de toda a operação. Quando MAPI_TOP_LEVEL não é definido, o valor máximo é considerado local e os provedores o usam internamente para exibir progresso para subobjetos de nível inferior. Objetos de progresso salvam o valor máximo local apenas para devolvê-lo a um provedor por meio de uma chamada GetMax .

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

Observações para implementadores

Inicialize o valor máximo para 1000. Para redefinir esse valor, os provedores de serviços podem chamar o método IMAPIProgress::SetLimits. Para obter mais informações sobre como implementar o GetMax e os outros métodos IMAPIProgress , consulte Implementando um Indicador de Progresso.

Referência do MFCMAPI

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

Confira também

IMAPIProgress::GetMin

IMAPIProgress::Progress

IMAPIProgress::SetLimits

IMAPIProgress : IUnknown

MFCMAPI como exemplo de código

Exibir um indicador de progresso

Como implementar um indicador de progresso