أسلوب IHostAssemblyManager::GetNonHostStoreAssemblies

مقالة
11/01/2010

الحصول مؤشر واجهة إلى ICLRAssemblyReferenceList والذي يمثل قائمة تجميعات التي يتوقع مضيف وقت تشغيل اللغة العامة (CLR) إلى تحميل.

HRESULT GetNonHostStoreAssemblies (
    [out] ICLRAssemblyReferenceList **ppReferenceList
);

المعلمات

ppReferenceList
[خارج] مؤشر إلى العنوان ICLRAssemblyReferenceListالذي يحتوي على قائمة مراجع للتجميعات التي يتوقع مضيف CLR للتحميل.

القيمة المُرجعة

hresult	الوصف
S_OK	GetNonHostStoreAssemblies returned successfully.
HOST_E_CLRNOTAVAILABLE	The CLR has not been تم تحميله في a عملية, أو the CLR هو in a الولاية in which it cannot تشغيل مدارة تعليمات برمجية أو عملية the يتصل successfully.
HOST_E_TIMEOUT	The يتصل timed خارج.
HOST_E_NOT_OWNER	The caller does not own the قفل.
HOST_E_ABANDONED	An حدث was canceled while a blocked مؤشر ترابط أو fiber was جارى الإنتظار تشغيل it.
E_FAIL	An مجهول catastrophic فشل occurred. عند إرجاع أسلوب E_FAIL، CLR هو لم تعد قابلة للاستخدام في العملية. المكالمات اللاحقة إلى المضيف للأساليب إرجاع HOST_E_CLRNOTAVAILABLE.
e_outofmemory	لم لا توجد ذاكرة كافية متوفرة إلى إنشاء قائمة مراجع ل المطلوب ICLRAssemblyReferenceList.

ملاحظات

يحل CLR المراجع باستخدام التعيين الإرشادات العامة التالية:

أولاً، فإنه consults قائمة مراجع تجميع الذي تم إرجاعه بواسطة GetNonHostStoreAssemblies.
إذا ظهر تجميع في القائمة، يتم ربط CLR إلى عليه عادة.
إذا لم يظهر تجميع في القائمة و قد وفر مضيف تطبيق من IHostAssemblyStore، يستدعي CLR IHostAssemblyStore::ProvideAssembly للسماح بالمضيف بتوفير تجميع إلى يربط.
وإلا يفشل CLR إلى يربط تجميع.

إذا كان مضيف يعين ppReferenceListالمكالمات إلى null، probes أول CLR في مخزن التجميع العمومي المؤقت ProvideAssembly، و ثم probes هو أساس تطبيق لحل على مرجع تجميع.

ملاحظة
عند تهيئة، يستدعي CLR GetNonHostStoreAssembliesفقط مرة واحدة فقط.الأسلوب هو لا استدعاء مرة أخرى.