Objetos de status MAPI

Aplica-se a: Outlook 2013 | Outlook 2016

Os objetos de status relatam informações sobre recursos MAPI. Por exemplo, um provedor de serviços, o processo de envio/recebimento MAPI ou o catálogo de endereços.

Há um objeto de status que fornece informações sobre cada provedor de serviços individual no perfil atual. O MAPI é responsável por implementar objetos de status para o subsistema, o processo de envio/recebimento MAPI e o catálogo de endereços. O objeto de status do subsistema fornece informações globais. O objeto de status para o catálogo de endereços integrado fornece o status de todos os provedores de catálogo de endereços atualmente em operação.

Cada objeto de status é incluído na tabela de status, uma tabela mantida pela MAPI que fornece aos clientes todas as informações de status da sessão. Para obter mais informações, consulte Tabelas de Status. Os clientes podem acessar um objeto de status específico por meio da tabela ou, no caso de um provedor de serviços, por meio de seu objeto de logon. Por exemplo, para acessar o objeto de status de um provedor de catálogo de endereços, um cliente pode chamar IABLogon::OpenStatusEntry. Para obter mais informações, consulte IABLogon::OpenStatusEntry.

Os clientes podem usar objetos de status para:

• Saiba mais sobre o estado de uma sessão.

• Monitorar um provedor de serviços.

• Controlar transmissão de mensagens.

• Exiba ou altere a configuração e o status de um recurso.

Cada objeto de status implementa a interface IMAPIStatus . Para obter mais informações, consulte IMAPIStatus : IMAPIProp. No entanto, nem todo objeto de status dá suporte total a todos os métodos IMAPIStatus . Como há variação nos métodos suportados por um objeto de status, os clientes precisam aprender sobre um objeto de status específico antes de usá-lo. Os objetos Status são necessários para publicar informações sobre seus recursos nas três propriedades a seguir:

PR_RESOURCE_METHODS (PidTagResourceMethods)

PR_RESOURCE_TYPE (PidTagResourceType)

PR_RESOURCE_FLAGS (PidTagResourceFlags)

Para obter mais informações sobre como implementar um objeto de status, consulte Implementação do objeto de status. Para obter mais informações sobre como usar um objeto de status, consulte Tabela de status e objetos de status.