ICLRErrorReportingManager::BeginCustomDump, metod
Anger konfigurationen av anpassade heap-dumpar för felrapportering.
Syntax
HRESULT BeginCustomDump (
[in] ECustomDumpFlavor dwFlavor,
[in] DWORD dwNumItems,
[in, size_is(dwNumItems), length_is(dwNumItems)] CustomDumpItem items[],
DWORD dwReserved
);
Parametrar
dwFlavor
[in] Ett ECustomDumpFlavor-värde som anger vilken typ av heapdump som den anpassade heapdumpen ska byggas på.
dwNumItems
[in] Matrisens items längd. Om dwFlavor inte är DUMP_FLAVOR_Mini dwNumItems ska vara noll.
items
[in] En matris med CustomDumpItem-instanser som anger de objekt som ska läggas till i minidumpen. Om dwFlavor inte är DUMP_FLAVOR_Mini items ska vara null.
dwReserved
[in] Reserverad för framtida användning.
Returvärde
| HRESULT | Description |
|---|---|
| S_OK | Metoden returnerades. |
| HOST_E_CLRNOTAVAILABLE | CLR (Common Language Runtime) har inte lästs in i en process eller så är CLR i ett tillstånd där den inte kan köra hanterad kod eller bearbeta anropet. |
| HOST_E_TIMEOUT | Tidsgränsen för samtalet överst. |
| HOST_E_NOT_OWNER | Anroparen äger inte låset. |
| HOST_E_ABANDONED | En händelse avbröts medan en blockerad tråd eller fiber väntade på den. |
| E_FAIL | Ett okänt oåterkalleligt fel inträffade. När en metod returnerar E_FAIL kan CLR inte längre användas i processen. Efterföljande anrop till värdmetoder returnerar HOST_E_CLRNOTAVAILABLE. |
Kommentarer
Metoden BeginCustomDump anger anpassad heapdumpkonfiguration. Metoden EndCustomDump rensar konfigurationen av den anpassade heapdumpen och frigör alla associerade tillstånd. Det bör anropas när den anpassade heapdumpen har slutförts.
Viktigt
Om det inte anropas EndCustomDump läcker minnet.
Krav
Plattformar: Se Systemkrav.
Huvudet: MSCorEE.h
Bibliotek: Ingår som en resurs i MSCorEE.dll
.NET Framework versioner: Tillgänglig sedan 2.0
