IManagedAddin - интерфейс

Статья
10/10/2023

Реализуйте интерфейс IManagedAddin, чтобы создать компонент, который загружает управляемые надстройки VSTO. Этот интерфейс был добавлен в систему 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();
};

Методы

В следующей таблице перечислены методы, определенные интерфейсом IManagedAddin.

Имя	Описание
IManagedAddin::Load	Вызывается, когда приложение Microsoft Office загружает управляемую надстройку VSTO.
IManagedAddin::Unload	Вызывается непосредственно перед тем, как приложение Microsoft Office выгружает управляемую надстройку VSTO.

Замечания

Microsoft Приложение Office lications, начиная с системы Microsoft Office 2007, используйте интерфейс IManagedAddin для загрузки надстроек VSTO Office. Интерфейс IManagedAddin можно реализовать для создания собственного загрузчика надстройки VSTO и среды выполнения для управляемых надстроек VSTO, а не с помощью загрузчика надстройки VSTO (VSTOLoader.dll) и среды выполнения набор средств Visual Studio для Office. Для получения дополнительной информации см. Architecture of VSTO Add-ins.

Загрузка управляемых надстроек

При запуске приложения происходит следующее.

Приложение обнаруживает надстройки VSTO путем поиска записей в следующем разделе реестра:

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

Каждая запись в этом разделе реестра представляет собой уникальный идентификатор надстройки VSTO. Как правило, это имя сборки надстройки VSTO.
Приложение ищет запись Manifest под записью для каждой надстройки VSTO.

Управляемые надстройки VSTO могут хранить полный путь манифеста в записи в Manifest разделе HKEY_CURRENT_USER\Software\Microsoft\Office\<application name>\Addins\addins\<add-in ID>. Манифест представляет собой файл (как правило, XML-файл), предоставляющий сведения, используемые для загрузки надстройки VSTO.
Если приложение находит запись Manifest , приложение пытается загрузить компонент загрузчика управляемой надстройки VSTO. Это делает приложение, пытаясь создать COM-объект, реализующий интерфейс IManagedAddin.

Среда выполнения набор средств Visual Studio для Office включает компонент загрузчика надстройки VSTO (VSTOLoader.dll) или можно создать собственный, реализуя интерфейс IManagedAddin.
Приложение вызывает метод IManagedAddin::Load и передает в него значение записи Manifest .
Метод IManagedAddin::Load выполняет задачи, необходимые для загрузки надстройки VSTO, такие как настройка политики безопасности и домена приложения для загружаемой надстройки VSTO.

Дополнительные сведения о разделах реестра, используемых корпорацией Майкрософт Приложение Office lications для обнаружения и загрузки управляемых надстроек VSTO, см. в разделах реестра для надстроек VSTO.

Руководство по реализации IManagedAddin

При реализации IManagedAddin необходимо зарегистрировать библиотеку DLL, содержащую реализацию, с помощью следующего CLSID:

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

Microsoft Приложение Office lications использует этот CLSID для создания COM-объекта, реализующего IManagedAddin.

Внимание

Этот CLSID также используется VSTOLoader.dll в среде выполнения набор средств Visual Studio для Office. Таким образом, если вы используете IManagedAddin для создания собственного компонента надстройки VSTO и компонента среды выполнения, вы не можете развернуть компонент на компьютерах под управлением надстроек VSTO, использующих среду выполнения набор средств Visual Studio для Office.

См. также

Справочник по неуправляемых API (разработка Office в Visual Studio)

Поделиться через