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.

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.

Siehe auch

• Nicht verwaltete API-Referenz (Office-Entwicklung in Visual Studio)