interfaz IManagedAddin
Implemente la interfaz IManagedAddin para crear un componente que cargue complementos VSTO administrados. Esta interfaz se agregó en el sistema de Microsoft Office 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();
};
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. |
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.
Se producen los pasos siguientes cuando se inicia una aplicación:
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.
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.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.
La aplicación llama al método IManagedAddin::Load y pasa el valor de la entrada
Manifest
.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.
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 .