Freigeben über


IManagedAddin-Schnittstelle

Implementieren Sie die IManagedAddin-Schnittstelle, um eine Komponente zu erstellen, die verwaltete VSTO-Add-Ins lädt. Diese Schnittstelle wurde im Microsoft Office System 2007 hinzugefügt.

Syntax

[
    object,
    uuid(B9CEAB65-331C-4713-8410-DDDAF8EC191A),
    pointer_default(unique),
    oleautomation
]
interface IManagedAddin : IUnknown
{
    HRESULT Load(
        [in] BSTR bstrManifestURL,
        [in] IDispatch *pdispApplication);
    HRESULT Unload();
};

Methoden

In der folgenden Tabelle sind die Methoden aufgeführt, die von der IManagedAddin-Schnittstelle definiert werden.

Name Beschreibung
IManagedAddin::Load Wird aufgerufen, wenn eine Microsoft Office-Anwendung ein verwaltetes VSTO-Add-In lädt.
IManagedAddin::Unload Wird aufgerufen, direkt bevor eine Microsoft Office-Anwendung ein verwaltetes VSTO-Add-In entlädt.

Hinweise

Microsoft Office-App lizenzierungen ab dem 2007 Microsoft Office System verwenden die IManagedAddin-Schnittstelle, um Office VSTO-Add-Ins zu laden. Sie können die IManagedAddin-Schnittstelle implementieren, um Ihr eigenes VSTO-Add-In-Ladeprogramm und die Laufzeit für verwaltete VSTO-Add-Ins zu erstellen, anstatt das VSTO-Add-In-Ladeprogramm (VSTOLoader.dll) und Visual Studio-Tools für Die Office-Laufzeit zu verwenden. Weitere Informationen finden Sie unter Architecture of VSTO Add-ins.

Wie verwaltete Add-Ins geladen werden

Die folgenden Schritte werden beim Start einer Anwendung ausgeführt:

  1. Die Anwendung ermittelt VSTO-Add-Ins, indem sie Einträge unter dem folgenden Registrierungsschlüssel sucht:

    HKEY_CURRENT_USER\Software\Microsoft\Office\<Anwendungsname>\Addins\

    Jeder Eintrag unter diesem Registrierungsschlüssel entspricht einer eindeutigen ID des VSTO-Add-Ins. In der Regel ist dies der Name der VSTO-Add-In-Assembly.

  2. Die Anwendung sucht unter dem Eintrag für jedes VSTO-Add-In nach einem Manifest -Eintrag.

    Verwaltete VSTO-Add-Ins können den vollständigen Pfad eines Manifests im Eintrag unter HKEY_CURRENT_USER\Software\Microsoft\Office\<Anwendungsname>\Addins\<Add-In-ID> speichern.Manifest Ein Manifest ist eine Datei (normalerweise eine XML-Datei), die Informationen zum Laden des VSTO-Add-Ins bereitstellt.

  3. Wenn die Anwendung einen Manifest -Eintrag findet, versucht sie, eine Ladekomponenten für verwaltete VSTO-Add-Ins zu laden. Die Anwendung führt dies durch Den Versuch, ein COM-Objekt zu erstellen, das die IManagedAddin-Schnittstelle implementiert.

    Die Visual Studio-Tools für Office-Laufzeit enthält eine VSTO-Add-In-Ladekomponente (VSTOLoader.dll), oder Sie können eigene erstellen, indem Sie die IManagedAddin-Schnittstelle implementieren.

  4. Die Anwendung ruft die IManagedAddin::Load -Methode auf und übergibt den Wert des Manifest -Eintrags.

  5. Die IManagedAddin::Load -Methode führt zum Laden des VSTO-Add-Ins erforderliche Aufgaben wie das Konfigurieren der Anwendungsdomäne und der Sicherheitsrichtlinie für das VSTO-Add-In aus, das geladen wird.

    Weitere Informationen zu den Registrierungsschlüsseln, die Microsoft Office-App lizenzen zum Ermitteln und Laden verwalteter VSTO-Add-Ins verwenden, finden Sie unter Registrierungseinträge für VSTO-Add-Ins.

Anleitung zur Implementierung von IManagedAddin

Wenn Sie IManagedAddin implementieren, müssen Sie die DLL registrieren, die die Implementierung enthält, indem Sie die folgende CLSID verwenden:

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

Microsoft Office-App lications verwenden diese CLSID, um das COM-Objekt zu erstellen, das IManagedAddin implementiert.

Achtung

Diese CLSID wird auch von VSTOLoader.dll in der Visual Studio-Tools für Office-Laufzeit verwendet. Wenn Sie daher IManagedAddin zum Erstellen Ihrer eigenen VSTO-Add-In-Ladeprogramm- und Laufzeitkomponente verwenden, können Sie Ihre Komponente nicht auf Computern bereitstellen, auf denen VSTO-Add-Ins ausgeführt werden, die auf der Visual Studio-Tools für Office-Laufzeit basieren.

Siehe auch