أسلوب IHostAssemblyStore::ProvideModule

مقالة
11/01/2010

تقدم هذه المقالة حلاً وحدة نمطية? داخل تجميع أو ملف مورد مرتبط (ولكن لا مضمن).

HRESULT ProvideModule (
    [in]  ModuleBindInfo *pBindInfo,
    [out] DWORD          *pdwModuleId,
    [out] IStream        **ppStmModuleImage,
    [out] IStream        **ppStmPDB
);

المعلمات

pBindInfo
[في] مؤشر إلى مثيل ModuleBindInfo يصف وحدة نمطية? المطلوبة AppDomain، تجميع، و اسم وحدة نمطية?.
pdwModuleId
[خارج] مؤشر إلى معرّف فريد IStreamيحتوي على تم تحميله وحدة نمطية?.
ppStmModuleImage
[خارج] مؤشر إلى العنوان IStreamالكائن الذي يحتوي على الملف التنفيذي (PE) المحمول نسخة يمكن تم تحميله، أو null في حالة تعذر العثور على وحدة نمطية?.
ppStmPDB
[خارج] مؤشر إلى العنوان IStreamكائن، الذي يحتوي على البرنامج وتصحيح المعلومات (PDB) للوحدة النمطية المطلوبة، أو null في حالة تعذر العثور على الملف.pdb.

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

hresult	الوصف
S_OK	ProvideModule returned successfully.
HOST_E_CLRNOTAVAILABLE	لم يتم تم تحميله وقت تشغيل اللغة العامة (CLR) في إحدى العمليات أو CLR هو في الولاية حيث لا يقوم بتشغيل تعليمات برمجية تمت إدارتها أو معالجة الاستدعاء بنجاح.
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.
ERROR_FILE_NOT_FOUND	مورد المرتبطة أو تجميع المطلوب تعذر تحديد موقع.
error_insufficient_buffer	pdwModuleIdهو لا يكفي لاحتواء معرّف مضيف يريد العائد.

ملاحظات

The الهوية القيمة returned for pdwModuleId هو specified بواسطة the مضيف. Identifiers must be فريد within the مدة بقاء of a عملية. CLR يستخدم هذه القيمة كـ المعرف الفريد للتدفق كـ sociated. التحقق من كل قيمة من قيم pAssemblyIdيتم إرجاعها بواسطة استدعاء من ProvideAssembly وضد قيم pdwModuleIdالتي يتم إرجاعها بواسطة غير ذلك المكالمات إلى ProvideModule. إذا قام مضيف بإرجاع نفس القيمة معرّف ل آخر IStream، CLR بفحص ما إذا كان الفعل تم تعيين محتويات ذلك التدفق. إذا كان ذلك، يحمل CLR النسخة موجود من الصورة بدلاً من تعيين جديد واحد. لذلك، المعرف يجب أيضا عدم يتداخل مع معرفات تجميع الذي تم إرجاعه من ProvideAssembly.