Interface IManagedAddin

Artigo
02/25/2013

Implementar a IManagedAddin suplementos gerenciados de interface para criar um componente que carrega.Essa interface foi adicionada no sistema de Microsoft Office de 2007.

[
    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 que são definidos pelo IManagedAddin interface.

Nome	Descrição
IManagedAddin::Load	Chamado quando um Microsoft Office o aplicativo carrega um suplemento gerenciado.
IManagedAddin::Unload	Chamado antes de um Microsoft Office aplicativo descarrega um suplemento gerenciado.

Comentários

Aplicativos de Microsoft Office, iniciando com o sistema de Microsoft Office de 2007, usam o IManagedAddin interface para ajudar a carregar os suplementos do Office.Você pode implementar a IManagedAddin interface para criar seu próprio carregador de suplementos e o tempo de execução gerenciado add-ins, em vez de usar o carregador suplemento (VSTOLoader.dll) e Visual Studio Tools for Office Runtime.Para obter mais informações, consulte Arquitetura dos suplementos de nível de aplicativo.

Como suplementos gerenciados são 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 nesta chave do registro é uma identificação exclusiva do add-in.Normalmente, isso é o nome do assembly do suplemento.
O aplicativo procura um Manifest entrada sob a entrada para cada suplemento.

Suplementos gerenciados podem armazenar o caminho completo de um manifesto na Manifest entrada em 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 gerenciado pelo suplemento carregador.O aplicativo faz isso tentando criar um objeto COM que implementa o IManagedAddin interface.

O Visual Studio Tools for Office Runtime inclui um componente de carregador de suplementos (VSTOLoader.dll), ou você pode criar seus próprios por implementar a IManagedAddin interface.
O aplicativo chama o IManagedAddin::Load método e passa no valor da Manifest entrada.
O IManagedAddin::Load método executa as tarefas necessárias para carregar o add-in, como, por exemplo, configurando a diretiva de segurança e de domínio de aplicativo para o suplemento que está sendo carregada.

Para obter mais informações sobre o registro chaves usadas por aplicativos de Microsoft Office para descobrir e carregar suplementos gerenciados, consulte Entradas de registro de suplementos em nível de aplicativo.

Orientação para a implementação de IManagedAddin

Se você implementar IManagedAddin, você deve registrar a DLL que contém a implementação por meio do seguinte CLSID:

99D651D7-5F7C-470E-8A3B-774D5D9536AC

Aplicativos Microsoft Office usam este CLSID para criar o objeto COM que implementa IManagedAddin.

Cuidado
Esta CLSID também é usada pelo VSTOLoader.dll na Visual Studio Tools for Office Runtime.Portanto, se você usar IManagedAddin para criar seu próprio suplemento carregador e o componente de tempo de execução, não é possível implantar seu componente para computadores que estejam executando suplementos que contam com o Visual Studio Tools for Office Runtime.

Consulte também

Outros recursos

Referência de API não gerenciada (desenvolvimento do Office em Visual Studio)

Compartilhar via