interfaz IManagedAddin

  • Artículo

Implemente la interfaz IManagedAddin para crear un componente que cargue complementos VSTO administrados. Esta interfaz se agregó en el sistema de Microsoft Office 2007.

Sintaxis

[
    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

En la tabla siguiente se enumeran los métodos definidos por la interfaz IManagedAddin.

Nombre Descripción
IManagedAddin::Load Se llama a este método cuando una aplicación de Microsoft Office carga un complemento de VSTO administrado.
IManagedAddin::Unload Se llama a este método justo antes de que una aplicación de Microsoft Office descargue un complemento de VSTO administrado.

Comentarios

Microsoft aplicación de Office lications, a partir del sistema de Microsoft Office 2007, use la interfaz IManagedAddin para ayudar a cargar complementos de VSTO de Office. Puede implementar la interfaz IManagedAddin para crear su propio cargador de complementos de VSTO y el entorno de ejecución para complementos VSTO administrados, en lugar de usar el cargador de complementos de VSTO (VSTOLoader.dll) y Visual Studio Tools para Office runtime . Para obtener más información, consulta Architecture of VSTO Add-ins.

Cómo se cargan los complementos administrados

Se producen los pasos siguientes cuando se inicia una aplicación:

  1. La aplicación detecta los complementos de VSTO buscando las entradas en la siguiente clave del registro:

    HKEY_CURRENT_USER\Software\Microsoft\Office\<application name>\Addins\

    Cada entrada de esta clave del Registro es un identificador único del complemento de VSTO. Normalmente, se trata del nombre del ensamblado de complemento de VSTO.

  2. La aplicación busca una entrada Manifest en la entrada de cada complemento de VSTO.

    Los complementos VSTO administrados pueden almacenar la ruta de acceso completa de un manifiesto en la entrada en HKEY_CURRENT_USER\Software\Microsoft\Office\<nombre> de aplicación\Addins\<id. de complemento>.Manifest Un manifiesto es un archivo (normalmente un archivo XML) que ofrece información que se usa para cargar el complemento de VSTO.

  3. Si la aplicación encuentra una entrada Manifest , la aplicación intenta cargar un componente de cargador de complemento de VSTO administrado. La aplicación lo hace intentando crear un objeto COM que implemente la interfaz IManagedAddin.

    El entorno de ejecución de Visual Studio Tools para Office incluye un componente del cargador de complementos de VSTO (VSTOLoader.dll) o puede crear su propio mediante la implementación de la interfaz IManagedAddin.

  4. La aplicación llama al método IManagedAddin::Load y pasa el valor de la entrada Manifest .

  5. El método IManagedAddin::Load realiza las tareas necesarias para cargar el complemento de VSTO, tales como la configuración de la directiva de seguridad y dominio de la aplicación para el complemento de VSTO que está cargando.

    Para obtener más información sobre las claves del Registro que Microsoft aplicación de Office lications usa para detectar y cargar complementos VSTO administrados, consulte Entradas del Registro para complementos de VSTO.

Guía para implementar IManagedAddin

Si implementa IManagedAddin, debe registrar el archivo DLL que contiene la implementación mediante el clSID siguiente:

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

Microsoft aplicación de Office lications usa este CLSID para crear el objeto COM que implementa IManagedAddin.

Precaución

VSTOLoader.dll también usa este CLSID en el entorno de ejecución de Visual Studio Tools para Office . Por lo tanto, si usa IManagedAddin para crear su propio cargador de complementos de VSTO y su componente en tiempo de ejecución, no puede implementar el componente en equipos que ejecutan complementos de VSTO que se basan en el entorno de ejecución de Visual Studio Tools para Office .

Consulte también