Rozhraní IManagedAddin

Článek
03/04/2013

Implementace IManagedAddin vytvořit komponentu, která načítá rozhraní Spravovat doplňky.Toto rozhraní byla přidána v systému 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();
};

Metody

Následující tabulka obsahuje seznam metod, které jsou definovány IManagedAddin rozhraní.

Název	Description
IManagedAddin::Load	Při Microsoft Office aplikace načte spravované doplněk.
IManagedAddin::Unload	Nazývá těsně před Microsoft Office aplikace uvolní spravované doplněk.

Poznámky

Použití aplikace sady Microsoft Office, počínaje systému Microsoft Office 2007, IManagedAddin rozhraní k načtení doplňků sady Office.Můžete implementovat IManagedAddin rozhraní vytvořit přidat loader a runtime pro spravované doplňky, namísto použití doplňku loader (VSTOLoader.dll) a Visual Studio Tools for Office runtime.Další informace naleznete v tématu Architektura doplňků úroveň aplikace.

Jak spravované doplňky jsou načteny.

Při spuštění aplikace proběhnou následující kroky:

Aplikace zjistí doplňky vyhledávání položek v následujícím klíči registru:

HKEY_CURRENT_USER\Software\Microsoft\Office\< název aplikace >\Addins\

Každá položka v tomto klíči registru je jedinečné ID v.Obvykle je název sestavení doplněk.
Aplikace vyhledá Manifest položku položka pro každý doplněk.

Spravované doplňky lze uložit úplnou cestu v manifestu Manifest položku HKEY_CURRENT_USER\Software\Microsoft\Office\< název aplikace >\Addins\< ID v >.Manifest je soubor (obvykle soubor XML), který poskytuje informace, které slouží k načtení doplňku.
Pokud aplikace najde Manifest položka, aplikace se pokusí načíst komponentu spravované přidat loader.Aplikace provádí při pokusu o vytvoření objektu COM, který implementuje IManagedAddin rozhraní.

Visual Studio Tools for Office runtime Zahrnuje komponentu přidat loader (VSTOLoader.dll), nebo můžete vytvořit vlastní podle prováděcích IManagedAddin rozhraní.
Volání aplikace IManagedAddin::Load metoda a průchodů hodnoty Manifest položku.
IManagedAddin::Load Metoda provádí úlohy nutné načíst doplněk, jako je například konfigurace zásad domény a zabezpečení aplikací pro doplněk, který je načítán.

Další informace o registru spravované klíčů, které aplikace sady Microsoft Office použít ke zjištění a načtení doplňků naleznete v tématu Položky registru pro doplňky úroveň aplikace.

Pokyny pro provádění IManagedAddin

Pokud implementujete IManagedAddin, je nutné zaregistrovat knihovnu DLL, která obsahuje implementaci pomocí následujícího identifikátoru CLSID:

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

Aplikace sady Microsoft Office použít k vytvoření objektu COM, který implementuje tento identifikátor CLSID IManagedAddin.

Upozornění
Tento identifikátor CLSID se používá také v VSTOLoader.dll Visual Studio Tools for Office runtime.Proto pokud používáte IManagedAddin Chcete-li vytvořit vlastní doplněk loader a runtime komponent, nelze implementovat komponenty počítačů používajících doplňky, které jsou závislé na Visual Studio Tools for Office runtime.

Viz také

Další zdroje

Nespravovaná API Reference (vývoj sady Office v aplikaci Visual Studio)

Sdílet prostřednictvím