Antarmuka IManagedAddin

Artikel
10/10/2023

Terapkan antarmuka IManagedAddin untuk membuat komponen yang memuat Add-in VSTO terkelola. Antarmuka ini ditambahkan dalam sistem Microsoft Office 2007.

Sintaks

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

Metode

Tabel berikut mencantumkan metode yang ditentukan oleh antarmuka IManagedAddin.

Nama	Deskripsi
IManagedAddin::Load	Dipanggil saat Microsoft aplikasi Office lication memuat Add-in VSTO terkelola.
IManagedAddin::Unload	Dipanggil tepat sebelum Microsoft aplikasi Office lication membongkar Add-in VSTO terkelola.

Keterangan

Microsoft aplikasi Office lications, dimulai dengan sistem Microsoft Office 2007, menggunakan antarmuka IManagedAddin untuk membantu memuat Add-in Office VSTO. Anda dapat menerapkan antarmuka IManagedAddin untuk membuat loader Add-in VSTO dan runtime Anda sendiri untuk Add-in VSTO terkelola, alih-alih menggunakan add-in loader VSTO (VSTOLoader.dll) dan Alat Visual Studio untuk runtime Office . Untuk informasi selengkapnya, lihat Arsitektur Add-in VSTO.

Bagaimana Add-in terkelola dimuat

Langkah-langkah berikut terjadi ketika aplikasi dimulai:

Aplikasi ini menemukan Add-in VSTO dengan mencari entri di bawah kunci registri berikut:

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

Setiap entri di bawah kunci registri ini adalah ID unik dari Add-in VSTO. Biasanya, ini adalah nama rakitan Add-in VSTO.
Aplikasi mencari Manifest entri di bawah entri untuk setiap Add-in VSTO.

Add-in VSTO terkelola dapat menyimpan jalur lengkap manifes dalam Manifest entri di bawah id HKEY_CURRENT_USER\Software\Microsoft\Office\<application name>\Addins\<add-in.> Manifes adalah file (biasanya, file XML) yang menyediakan informasi yang digunakan untuk membantu memuat Add-in VSTO.
Jika aplikasi menemukan Manifest entri, aplikasi mencoba memuat komponen add-in loader VSTO terkelola. Aplikasi melakukan ini dengan mencoba membuat objek COM yang mengimplementasikan antarmuka IManagedAddin.

Runtime Visual Studio Tools for Office menyertakan komponen pemuat Add-in VSTO (VSTOLoader.dll), atau Anda dapat membuat sendiri dengan menerapkan antarmuka IManagedAddin.
Aplikasi memanggil metode IManagedAddin::Load dan meneruskan nilai Manifest entri.
Metode IManagedAddin::Load melakukan tugas yang diperlukan untuk memuat Add-in VSTO, seperti mengonfigurasi domain aplikasi dan kebijakan keamanan untuk Add-in VSTO yang sedang dimuat.

Untuk informasi selengkapnya tentang kunci registri yang digunakan Microsoft aplikasi Office lications untuk menemukan dan memuat Add-in VSTO terkelola, lihat Entri registri untuk Add-in VSTO.

Panduan untuk mengimplementasikan IManagedAddin

Jika Anda menerapkan IManagedAddin, Anda harus mendaftarkan DLL yang berisi implementasi dengan menggunakan CLSID berikut:

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

Microsoft aplikasi Office lications menggunakan CLSID ini untuk membuat objek COM yang mengimplementasikan IManagedAddin.

Perhatian

CLSID ini juga digunakan oleh VSTOLoader.dll di Visual Studio Tools untuk runtime Office . Oleh karena itu, jika Anda menggunakan IManagedAddin untuk membuat komponen loader dan runtime Add-in VSTO Anda sendiri, Anda tidak dapat menyebarkan komponen Anda ke komputer yang menjalankan Add-in VSTO yang mengandalkan Alat Visual Studio untuk runtime Office .

Bagikan melalui