IMAPIProgress : IUnknown
Aplica-se a: Outlook 2013 | Outlook 2016
Implementa um objeto de progresso que fornece aos aplicativos cliente um indicador de progresso. Um indicador de progresso é uma exibição de interface do usuário que mostra o percentual de conclusão de uma operação, como copiar pastas entre armazenamentos de mensagens. Os aplicativos MAPI e cliente implementam objetos de progresso e os provedores de serviços os usam.
| Propriedade | Valor |
|---|---|
| Arquivo de cabeçalho: |
Mapidefs.h |
| Exposto por: |
Objetos de progresso |
| Implementado por: |
APLICATIVOS MAPI e cliente |
| Chamado por: |
Provedores de serviços |
| Identificador de interface: |
IID_IMAPIProgress |
| Tipo de ponteiro: |
LPMAPIPROGRESS |
Vtable order
| Member | Descrição |
|---|---|
|
Progress |
Atualizações o indicador de progresso com uma exibição do progresso conforme ele é feito para a conclusão da operação. |
|
GetFlags |
Retorna as configurações do sinalizador do objeto de progresso para o nível de operação no qual as informações de progresso são calculadas. |
|
GetMax |
Retorna o número máximo de itens na operação para a qual as informações de progresso são exibidas. |
|
GetMin |
Retorna o valor mínimo no método SetLimits para o qual as informações de progresso são exibidas. |
|
SetLimits |
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. |
Comentários
MAPI inclui um parâmetro lpProgress em muitos dos métodos que executam operações potencialmente longas. lpProgress aponta para uma implementação do cliente de um objeto de progresso. Os clientes que implementam a interface IMAPIProgress definem esse parâmetro para apontar para sua implementação; os clientes que não implementam o IMAPIProgress definem o parâmetro como NULL. Para exibir um indicador de progresso durante o processamento da operação, os provedores de serviços usam o objeto de progresso fornecido pelo cliente, se disponível ou uma implementação MAPI (indicado quando lpProgress é definido como NULL).
Referência do MFCMAPI
Para ver códigos de exemplo do MFCMAPI, confira a tabela a seguir.
| Files | Function | Comentário |
|---|---|---|
| MapiProgress.h e MapiProgress.cpp |
Não aplicável |
Se a configuração IMAPIProgress estiver habilitada, o MFCMAPI passará uma implementação IMAPIProgress para todas as funções que o MFCMAPI invoca que aceitam uma implementação. |