Interface IManagedAddin

Artigo
08/25/2010

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
IManagedAddin::Load	Chamado quando um Microsoft Office aplicativo carrega um suplemento gerenciado.
IManagedAddin::descarregar	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.

Cuidado:
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)

Partilhar via