Compartilhar via

Visão geral do desligamento rápido

  • Artigo

Aplica-se a: Outlook 2013 | Outlook 2016

O desligamento rápido é um mecanismo para um cliente MAPI iniciar um desligamento rápido do processo de cliente, notificando todos os provedores com os quais o cliente tem uma sessão MAPI ativa para salvar dados e configurações antes da saída do processo do cliente. Este tópico descreve o mecanismo básico de desligamento rápido.

Começando em Microsoft Outlook 2010 e agora incluindo Microsoft Outlook 2013, o subsistema MAPI fornece a interface IMAPIClientShutdown : IUnknown. O Outlook e outros clientes MAPI podem adotar o desligamento rápido como o mecanismo padrão para sair do processo do cliente. Uma configuração no nível do usuário no registro do Windows do computador cliente controla a adoção de desligamento rápido para todos os clientes MAPI desse usuário nesse computador. Para obter detalhes sobre as configurações do registro, consulte Opções de usuário de desligamento rápido.

Se um cliente MAPI precisar adotar o desligamento rápido, ele deverá usar a interface IMAPIClientShutdown : IUnknown . A seguir está o curso típico de eventos quando o cliente tenta desligar:

  1. O cliente MAPI inicia o desligamento chamando o método IMAPIClientShutdown::QueryFastShutdown para determinar se o subsistema MAPI dá suporte a desligamento rápido.

  2. O subsistema MAPI responde com o suporte de desligamento rápido disponível para a chamada IMAPIClientShutdown::QueryFastShutdown usando o seguinte procedimento:

    1. O subsistema MAPI chama o método IMAPIProviderShutdown::QueryFastShutdown para cada provedor MAPI com o qual o processo cliente MAPI tem uma sessão MAPI ativa, se o provedor tiver implementado a interface IMAPIProviderShutdown : IUnknown .

      Observação

      O subsistema MAPI sempre consulta e notifica os provedores MAPI por meio da interface IMAPIProviderShutdown : IUnknown em cada sessão MAPI na seguinte ordem:

      1. Provedores de transporte
      2. Provedores de catálogo de endereços
      3. Provedores de armazenamento

    2. Dependendo da configuração de registro de desligamento rápido para esse usuário no computador cliente, o subsistema MAPI especifica o código de retorno apropriado para IMAPIClientShutdown::QueryFastShutdown. O código de retorno é S_OK ou MAPI_E_NO_SUPPORT.

    3. O cliente MAPI chama o método IMAPIClientShutdown::NotifyProcessShutdown para indicar ao subsistema MAPI a intenção de desligar.

    4. O subsistema MAPI indica a cada provedor MAPI carregado que o cliente MAPI será desligado. Para os provedores que implementaram a interface IMAPIProviderShutdown : IUnknown , o subsistema MAPI chama o método IMAPIProviderShutdown::NotifyProcessShutdown correspondente.

    5. O cliente MAPI chama o método IMAPIClientShutdown::D oFastShutdown para indicar ao subsistema MAPI que o processo cliente está saindo imediatamente.

    6. O subsistema MAPI indica a cada provedor MAPI carregado que o processo de cliente MAPI está saindo. Para os provedores que implementaram a interface IMAPIProviderShutdown : IUnknown , o subsistema MAPI chama o método IMAPIProviderShutdown::D oFastShutdown correspondente. Neste ponto, esses provedores MAPI devem verificar se todas as ações necessárias, como salvar dados e configurações, estão concluídas em preparação para o cliente MAPI desconectar imediatamente todas as referências e sair.

Confira também