ICorDebugProcess5::EnumerateHeap-metod
Hämtar en uppräknare för objekten på den hanterade heapen.
Syntax
HRESULT EnumerateHeap(
[out] ICorDebugHeapEnum **ppObjects
);
Parametrar
ppObject
[ut] En pekare till adressen för ett ICorDebugHeapEnum-gränssnittsobjekt som är en uppräknare för de objekt som finns på den hanterade heapen.
Kommentarer
Innan du anropar ICorDebugProcess5::EnumerateHeap
metoden bör du anropa metoden ICorDebugProcess5::GetGCHeapInformation och undersöka värdet areGCStructuresValid
för fältet för det returnerade COR_HEAPINFO-objektet för att säkerställa att skräpinsamlingens heap i dess aktuella tillstånd kan räknas upp. Dessutom ICorDebugProcess5::EnumerateHeap
returneras E_FAIL
om du ansluter för tidigt under processens livslängd, innan minnet för den hanterade heapen allokeras.
Gränssnittsobjektet ICorDebugHeapEnum är en standarduppräkning som härleds från gränssnittet ICorDebugEnum som gör att du kan räkna upp COR_HEAPOBJECT objekt. Den här metoden fyller samlingsobjektet ICorDebugHeapEnum med COR_HEAPOBJECT instanser som ger information om alla objekt. Samlingen kan också innehålla COR_HEAPOBJECT instanser som ger information om objekt som inte är rotade av något objekt men som ännu inte har samlats in av skräpinsamlaren.
Krav
Plattformar: Se Systemkrav.
Rubrik: CorDebug.idl, CorDebug.h
Bibliotek: CorGuids.lib
.NET Framework-versioner: Finns sedan 4.5