Suporte para manter suplementos habilitados

  • Artigo

Programas no Office 2013 e versões posteriores fornecem resiliência de suplemento, o que significa que os aplicativos desabilitarão um suplemento se ele for executado lentamente. No entanto, você pode habilitar novamente os suplementos e impedir que os suplementos sejam desabilitados automaticamente por outros programas do Office.

Impedir que suplementos sejam desabilitados

Embora a maioria dos suplementos não seja desabilitada pelo recurso de desabilitação do suplemento, você não quer que seu suplemento seja desabilitado consistentemente.

A seguir estão algumas sugestões para melhorar o desempenho do suplemento:

  • Prefira suplementos COM nativos em vez de suplementos gerenciados, pois os suplementos gerenciados devem incorrer na sobrecarga de carregar o .NET Framework durante a inicialização do Outlook.

  • Se você tiver tarefas de execução longa, como fazer uma conexão cara com um banco de dados, adie essas tarefas para ocorrer após a inicialização.

  • Se possível, cache dados localmente em vez de fazer chamadas de rede caras durante os eventos FolderSwitch e BeforeFolderSwitch de um explorador ou Abrir eventos de um item.

  • Esteja ciente de que todas as chamadas para o modelo de objeto do Outlook são executadas no main thread em primeiro plano do Outlook. Evite fazer chamadas de modelo de objeto do Outlook em execução longa, se possível.

  • No Outlook 2013, as chamadas para o modelo de objeto do Outlook retornam E_RPC_WRONG_THREAD quando o modelo de objeto do Outlook é chamado de um thread em segundo plano.

  • A votação é uma operação cara, então sempre prefira um modelo orientado a eventos em vez de sondagem.

Observação

Você não pode impedir o Outlook de desabilitar suplementos nas seguintes condições:

  • O suplemento trava o Outlook.

  • O suplemento não pode ser carregado.

Nesses casos, a causa da falha ou da falha de carregamento precisa ser corrigida junto com o proprietário do suplemento.

Controle de administrador do sistema sobre suplementos

O usuário tem controle sobre quais suplementos são executados em seu computador. A partir do Office 2013, os administradores do sistema podem configurar um nível avançado de controle para suplementos usando a política de grupo. A política de grupo sempre substituirá as configurações do usuário e os usuários serão impedidos de alterar as configurações de suplementos para suplementos que foram configurados pela lista de suplementos gerenciados da política de grupo.

Para o Outlook, as chaves e as configurações do registro são descritas nas tabelas a seguir.

Nome Descrição
Chave Office 2013:
HKEY_CURRENT_USER\Software\Policies\Microsoft\Office\15.0\Outlook\Resiliency\AddinList

Office 2016/2019/365:
HKEY_CURRENT_USER\Software\Policies\Microsoft\Office\16.0\Outlook\Resiliency\AddinList
Descrição Essa configuração de política permite especificar a lista de suplementos gerenciados que estão sempre habilitados, sempre desabilitados (bloqueados) ou configuráveis pelo usuário.

OBSERVAÇÃO: aqui, o termo "gerenciado" refere-se a suplementos tratados pela política de grupo e não se relaciona com suplementos que estão sendo desenvolvidos em linguagens de programação gerenciadas.
String ProgID do suplemento
Valores Especifique o valor da seguinte maneira:
0 = sempre desabilitado (bloqueado)
1 = sempre habilitado
2 = configurável pelo usuário e não bloqueado pela configuração de política Bloquear todos os suplementos não gerenciados quando habilitado.

Observação

Para obter o ProgID para um suplemento, use o Editor de Registro do Windows no computador cliente em que o suplemento está instalado. Copie os nomes de chave do registro em encontrado: HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Office\<application>\Addins ou HKEY_CURRENT_USER\SOFTWARE\Microsoft\Office\<application>\Addins. Os nomes das chaves do registro são sensíveis a maiúsculas de minúsculas.

  • Se você desabilitar ou não habilitar essa configuração de política, a lista de suplementos gerenciados será excluída. Se a configuração de política Bloquear todos os suplementos não gerenciados estiver habilitada, todos os suplementos serão bloqueados.

  • Os suplementos desabilitados por essa política nunca serão desabilitados pelo recurso de desabilitação do suplemento do Outlook, que desabilita suplementos por motivos de desempenho, resiliência ou confiabilidade.

  • Se o usuário escolher "Sempre habilitar esse suplemento", o registro será atualizado para incluir detalhes sobre o suplemento que deve ser isento do recurso de desabilitação automática.

Nome Descrição
Chave HKEY_CURRENT_USER\Software\Microsoft\Office\x.0\Outlook\Resiliency\DoNotDisableAddinList
Descrição Esta Chave impede que os suplementos especificados sejam desabilitados pelo recurso de desabilitação do suplemento.
DWORD ProgID do suplemento
Valores Um valor Hex entre 1 e A indicando o motivo pelo qual o suplemento foi originalmente desabilitado:
0x00000001 carga de inicialização (LoadBehavior = 3)
0x00000002 Carga de demanda (LoadBehavior = 9)
0x00000003 Crash
0x00000004 evento FolderSwitch
0x00000005 o evento BeforeFolderSwitch
0x00000006 Item Open
contagem de iteração 0x00000007
Desligamento 0x00000008
0x00000009 Falha, mas não desabilitado porque o suplemento está na lista de permissões
0x0000000A Falha, mas não desabilitado porque o usuário não selecionou nenhum na caixa de diálogo de desabilitar

OBSERVAÇÃO: o espaço reservado x.0 representa a versão do Office (16.0 = Office 2016/2019/365, 15.0 = Office 2013).

Observação

Se você habilitar novamente um suplemento que causou um problema de desempenho ao mesmo tempo, os usuários poderão ter problemas de desempenho no futuro no programa do Office para o qual o suplemento é carregado.

Para bloquear suplementos que não são gerenciados por esta configuração de política, você também deve definir a configuração de política Bloquear todos os suplementos não gerenciados.

Confira também

Suporte e comentários

Tem dúvidas ou quer enviar comentários sobre o VBA para Office ou sobre esta documentação? Confira Suporte e comentários sobre o VBA para Office a fim de obter orientação sobre as maneiras pelas quais você pode receber suporte e fornecer comentários.