Práticas recomendadas para o desligamento rápido
Aplica-se a: Outlook 2013 | Outlook 2016
Este tópico recomenda as melhores práticas para administradores, clientes MAPI e provedores MAPI usarem as configurações de registro do Windows e as interfaces de desligamento rápido para minimizar a perda de dados durante o desligamento do cliente.
Para que um cliente MAPI realize o desligamento rápido com êxito para que os processos do provedor não incorram em perda de dados, o cliente MAPI deve primeiro chamar o método IMAPIClientShutdown::QueryFastShutdown . Em seguida, o cliente deve continuar com os métodos IMAPIClientShutdown::NotifyProcessShutdown e IMAPIClientShutdown::D oFastShutdown com base no suporte do subsistema MAPI para desligamento rápido, conforme indicado pelo valor retornado de IMAPIClientShutdown::QueryFastShutdown. Como cliente MAPI, o Microsoft Outlook não chama IMAPIClientShutdown::NotifyProcessShutdown ou IMAPIClientShutdown::D oFastShutdown se IMAPIClientShutdown::QueryFastShutdown retornar um erro. Se o administrador tiver desabilitado o desligamento rápido no registro do Windows, o subsistema MAPI retornará MAPI_E_NO_SUPPORT ao IMAPIClientShutdown::QueryFastShutdown. Nesse caso, o subsistema MAPI não informaria os provedores MAPI de uma saída imediata do processo do cliente. Portanto, se um cliente MAPI ignorar esse código de retorno de erro, continuar a fazer desligamento rápido e desconectar todas as referências externas, todos os provedores MAPI carregados terão perda de dados.
Os provedores MAPI devem implementar a interface IMAPIProviderShutdown : IUnknown para executar etapas oportunas e necessárias para evitar a perda de dados devido ao cliente desconectar referências externas antes da saída do cliente. Um provedor deve adiar todo o resto que não é inocial para salvar dados em seu armazenamento de dados primário. Por exemplo, um provedor de transporte deve adiar operações desnecessárias em segundo plano que marcar para novos emails, um provedor de catálogo de endereços deve adiar o download de alterações recentes de seu servidor e um provedor de armazenamento deve adiar tarefas de manutenção, como compactação ou indexação.
Os usuários que desejam que os clientes MAPI saiam assim que os fecham devem usar a configuração padrão do registro que permite o desligamento rápido, a menos que um provedor opte por sair.
Depois que um cliente MAPI chamar IMAPIClientShutdown::D oFastShutdown, ele não deve fazer chamadas adicionais para MAPI, incluindo a função MAPIUninitialize . O cliente não deve usar MAPI para o restante do tempo de vida do processo de cliente.
Um cliente MAPI nunca deve chamar diretamente a interface IMAPIProviderShutdown de um provedor. Os clientes MAPI devem sempre usar a interface IMAPIClientShutdown : IUnknown .
Se um provedor MAPI precisar garantir que o desligamento rápido não seja usado enquanto estiver carregado, ele deverá implementar a interface IMAPIProviderShutdown e retornar MAPI_E_NO_SUPPORT para o método IMAPIProviderShutdown::QueryFastShutdown . No entanto, para clientes MAPI, como o Outlook, isso fará com que o cliente abandone o desligamento rápido e desista por mais tempo.
Confira também
Desligamento do cliente em MAPI