أسلوب IActionOnCLREvent::OnEvent

مقالة
11/01/2010

تنفيذ عمليات الاستدعاء تشغيل الأحداث التي تم تسجيلها باستخدام استدعاء إلى ICLROnEventManager::RegisterActionOnEvent الأسلوب.

HRESULT OnEvent (
    [in] EClrEvent event,
    [in] PVOID     data
);

المعلمات

event
[في] واحد قيم "EClrEvent ، الذي يشير إلى نوع حدث.
data
[في] مؤشر إلى كائن يحتوي على تفاصيل حول event.

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

hresult	الوصف
S_OK	OnEvent 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	تم الإلغاء حدث أثناء قيام مؤشر ترابط محظورة أو تم انتظار ألياف عليه.
E_FAIL	An مجهول catastrophic فشل occurred. في حالة إرجاع أسلوب E_FAIL، CLR هو لم تعد قابلة للاستخدام في العملية. إرجاع المكالمات اللاحقة إلى أي أسلوب استضافة HOST_E_CLRNOTAVAILABLE.

ملاحظات

dataمعلمة هو مؤشر إلى كائن من نوع غير محدد. إذا كانت eventمعلمة Event_DomainUnload، dataهو معرّف رقمي AppDomainالتي تم إلغاء تحميل. يمكن للمضيف اتخاذ إجراء المناسب باستخدام هذا المعرف كـ مفتاح.

إذا eventهو Event_MDAFired، dataمؤشر إلى مثيل MDAInfo "الذي يحتوي على إخراج الرسالة من التي تمت إدارتها التصحيح مساعد (MDA). MDAs هي إحدى ميزات CLR التي تساعد المطورين مع التصحيح، وذلك بإنشاء رسائل XML حول الأحداث وإلا يصعب إلى الاعتراض. مثل هذه الرسائل يمكن أن تكون مفيدة بشكل خاص في تصحيح الأخطاء الانتقالات بين إدارتها وتعليمه برمجية مدارة. لمزيد من المعلومات، راجع تشخيص أخطاء مع المساعدين التصحيح مدارة.