مشاركة عبر


أسلوب ICLRErrorReportingManager::BeginCustomDump

تعين تكوين مخصص يفرغ كومة ذاكرة مؤقتة للتقرير عن الخطأ.

HRESULT BeginCustomDump (
    [in] ECustomDumpFlavor dwFlavor,
    [in] DWORD dwNumItems,
    [in, size_is(dwNumItems), length_is(dwNumItems)] CustomDumpItem items[],
    DWORD dwReserved
);

المعلمات

  • dwFlavor
    [في] EمخصصDumpFlavor القيمة تشير إلى نوع النسخة الاحتياطية كومة ذاكرة مؤقتة على بناء مخصص النسخة الاحتياطية كومة ذاكرة مؤقتة.

  • dwNumItems
    [في] الطول itemsصفيفة. إذا dwFlavorهو لا DUMP_FLAVOR_Mini، dwNumItemsيجب أن يكون صفراً.

  • items
    [في] صفيفة مثيلات CustomDumpItem ، تحديد عناصر المراد إضافة إلى mini-النسخة الاحتياطية. إذا dwFlavorهو لا DUMP_FLAVOR_Mini، itemsيجب أن تكون خالية.

  • dwReserved
    [في] حجز للمستقبل استخدم.

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

hresult

الوصف

S_OK

أسلوب الذي تم إرجاعه بنجاح.

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.

ملاحظات

BeginCustomDumpتعيين أسلوب مخصص heap تفريغ تكوين. EndمخصصDump أسلوب مسح مخصص heap تفريغ تكوين وتحرير أية الولاية مقترنة. يجب استدعاء بعد النسخة الاحتياطية مخصصة لكومة الذاكرة المؤقتة على هو كاملة.

ملاحظة هامةهام

فشل إلى استدعاء EndCustomDumpيؤدي إلى الذاكرة إلى تسرب.

المتطلبات

الأنظمة الأساسية: See متطلبات النظام إطار عمل .NET.

**Header:**MSCorEE.idl

**المكتبة:**مُضمن كـ مورد في MSCorEE.dll

.NET Framework Versions: 4, 3.5 SP1, 3.5, 3.0 SP1, 3.0, 2.0 SP1, 2.0

راجع أيضًا:

المرجع

بنية CustomDumpItem

قائمة تعداد ECustomDumpFlavor

واجهة ICLRErrorReportingManager