واجهة IManagedAddin

تطبيق IManagedAddinواجهة لإنشاء مكون يقوم بتحميل المدارة إضافة-زر 'Ins'. تمت إضافة هذه الواجهة في 2007 Microsoft المكتب الالنظام.

[
    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::تحميل

تسمى عند Microsoft المكتب التطبيق بتحميل وظيفة الإضافية التي تمت إدارتها.

IManagedAddin::Unload

استدعاء فقط قبل Microsoft المكتب يلغي تطبيق وظيفة الإضافية التي تمت إدارتها.

ملاحظات

تطبيقات Microsoft المكتب 2010 Suite، بدءاً بنظام Microsoft المكتب 2010 Suite 2007، باستخدام IManagedAddinواجهة للمساعدة في تحميل المكتب إضافة-زر 'Ins'. تطبيق IManagedAddinواجهة لإنشاء الخاص بك إضافة-في محمل ووقت التشغيل لإدارة إضافة-زر 'Ins'، بدلاً من استخدام إضافة-في أداة تحميل (VSTOLoader.dll) و Visual Studio Tools لوقت تشغيل Office. لمزيد من المعلومات، راجع هندسة والوظائف الإضافية مستوى التطبيق.

كيف مدارة إضافة-هل تم تحميل وظائف

تظهر الخطوات التالية عند بدء تشغيل أحد تطبيقات:

  1. يكتشف تطبيق إضافة-وظائف بالبحث عن إدخالات ضمن المفتاح السجل التالي:

    \الوظائف الإضافية\ < اسم تطبيق > HKEY_CURRENT_USER\Software\Microsoft\المكتب\

    كل إدخال ضمن المفتاح السجل هذا هو المعرف فريد إضافة-في. بشكل عام، th هو هو اسم الوظيفة-في تجميع.

  2. يبحث تطبيق عن Manifestالإدخال ضمن الإدخال الخاص بكل إضافة-بوصة

    إدارة إضافة-زر 'Ins' بتخزين مسار الكامل لبيان في Manifestالإدخال ضمن HKEY_CURRENT_USER\Software\Microsoft\المكتب\ < اسم تطبيق > \إضافةزر 'Ins'\ < إضافة-في المعرف > . بيان هو ملف (عادة ملف XML) التي توفر المعلومات التي يتم استخدامها للمساعدة في تحميل إضافة-في.

  3. إذا وجد تطبيق Manifestالإدخال، يحاول تطبيق لتحميل مدار إضافة-في أداة تحميل مكوّن. يقوم تطبيق بهذا قبل محاولة إلى إنشاء كائن COM الذي يطبق في IManagedAddinالواجهة.

    Visual Studio Tools لوقت تشغيل Officeيتضمن إضافة-في أداة تحميل المكون (VSTOLoader.dll)، أو يمكنك إنشاء الخاصة بتطبيق IManagedAddinالواجهة.

  4. استدعاء تطبيق IManagedAddin::تحميلأسلوب و مسارات في القيمة Manifestإدخال.

  5. IManagedAddin::تحميلأسلوب تنفيذ المهام المطلوبة لتم تحميله الوظيفة الإضافية، مثل تكوين تطبيق الأمان والمجال النهج للوظيفة-في تلك هو تم تحميلهه.

لمزيد من المعلومات حول السجل المفاتيح التي Microsoft المكتب التطبيقات التي تستخدم للكشف عن وتحميل زر 'Ins' الإضافية المدارة، راجع إدخالات التسجيل للحصول على الوظائف الإضافية مستوى التطبيق.

لتطبيق IManagedAddin

إذا قمت بتطبيق IManagedAddin، يجب تسجيل DLL التي تحتوي على التطبيق بواسطة استخدام CLSID التالي:

99d651d7-5f7c-470e-8a3b-774d5d9536ac

Microsoft المكتب التطبيقات باستخدام هذا CLSID لإنشاء كائن COM الذي يطبق IManagedAddin.

ملاحظة تنبيهتنبيه

هذا CLSID هو أيضا استخدامها بواسطة VSTOLoader.dll في Visual Studio Tools لوقت تشغيل Office. ولذلك، إذا كنت تستخدم IManagedAddinإلى إنشاء الخاص بك الوظيفة الإضافية محمل ووقت تشغيل مكوّن، لا يمكن نشر مكوّن الخاص بك إلى أجهزة الكمبيوتر التي تقوم بتشغيل زر 'زر 'Ins'' الإضافية التي تعتمد تشغيل Visual Studio Tools لوقت تشغيل Office.

راجع أيضًا:

موارد أخرى

مرجع واجهة برمجة تطبيقات غير مدار (تطوير المكتب في ‏‫Visual Studio)