Interface IManagedAddin
Implementar o IManagedAddin interface para criar um componente que cargas gerenciado add-ins. Essa interface foi adicionada no 2007 Microsoft Office sistema.
[
object,
uuid(B9CEAB65-331C-4713-8410-DDDAF8EC191A),
pointer_default(unique),
oleautomation
]
interface IManagedAddin : IUnknown
{
HRESULT Load(
[in] BSTR bstrManifestURL,
[in] IDispatch *pdispApplication);
HRESULT Unload();
};
Métodos
A tabela a seguir lista os métodos definidos pelo IManagedAddin interface.
Nome |
Descrição |
---|---|
Chamado quando um Microsoft Office aplicativo carrega um suplemento gerenciado. |
|
Aplicativo chamado pouco antes de um Microsoft Office descarrega um suplemento gerenciado. |
Comentários
Aplicativos do Microsoft Office, começando com o Microsoft Office sistema de 2007, usam o IManagedAddin interface para ajudar a carregar Visual Studio Tools for Office Add-ins. Você pode implementar o IManagedAddin interface para criar seu próprio suplemento carregador e o tempo de execução gerenciado suplementos, em vez de usar o add-in loader (VSTOLoader.dll) e o tempo de execução incluídos com Visual Studio Tools for Office. Para obter mais informações sobre VSTOLoader.dll e o Visual Studio Tools for Office tempo de execução, consulte Arquitetura de nível de aplicativo Adicionar-ins.
Como suplementos gerenciado foram carregados
Quando um aplicativo é iniciado, ocorrem as seguintes etapas:
O aplicativo detecta suplementos procurando por entradas sob a seguinte chave do registro:
HKEY_CURRENT_USER\Software\Microsoft\Office\ nome do aplicativo > \Addins\
Cada entrada sob essa chave do registro é uma ID exclusiva do suplemento.Normalmente, esse é o nome do conjunto do suplemento.
O aplicativo procura um Manifest entrada sob a entrada para cada suplemento.
Suplementos gerenciado podem armazenar o caminho completo de um manifesto no Manifest entrada da HKEY_CURRENT_USER\Software\Microsoft\Office\nome do aplicativo >\Addins\<suplemento ID >.Um manifesto é um arquivo (normalmente, um arquivo XML) que fornece informações que são usadas para ajudar a carregar o suplemento.
Se o aplicativo localiza um Manifest entrada, o aplicativo tenta carregar um componente de carregador de suplementos gerenciado. O aplicativo faz isso ao tentar criar um objeto COM que implementa o IManagedAddin interface.
The Visual Studio Tools for Office tempo de execução inclui um componente do suplemento loader (VSTOLoader.dll) ou pode criar seus próprios por implementar o IManagedAddin interface.
O aplicativo chama o IManagedAddin::Load método e passar no valor da Manifest entrada.
The IManagedAddin::Load método executa sistema autônomo tarefas necessárias para carregar o suplemento, sistema autônomo configurar a diretiva de segurança e de domínio do aplicativo para o suplemento seja carregado.
Para obter mais informações sobre o registro chaves que usam aplicativos do Microsoft Office para detectar e carregar gerenciado add-ins, consulte Entradas de registro para Application-Nível Adicionar-ins.
Diretrizes para implementação IManagedAddin
Se você implementar IManagedAddin, você deve registrar a DLL que contém a implementação usando o seguinte CLSID:
99D651D7-5F7C-470E-8A3B-774D5D9536AC
Aplicativos do Microsoft Office usam essa CLSID para criar o objeto COM que implementa IManagedAddin.
![]() |
---|
Esta CLSID também é usada pelo VSTOLoader.dll no Visual Studio Tools for Office tempo de execução. Portanto, se você usar IManagedAddin Para criar seu próprio suplemento carregador e o componente em tempo de execução, não é possível implantar seu componente para computadores que estão executando suplementos criados usando Visual Studio Tools for Office. |
Consulte também
Outros recursos
Referência de API não gerenciado (Visual Studio Tools for Microsoft Office)