ICorDebugProcess5::EnumerateHeapRegions-Methode

Ruft einen Enumerator für die Speicherbereiche des verwalteten Heaps ab.

Syntax

HRESULT EnumerateHeapRegions(
   [out] ICorDebugHeapSegmentEnum **ppRegions
);

Die Parameter

ppRegions [out] Ein Zeiger auf die Adresse eines ICorDebugHeapSegmentEnum-Schnittstellenobjekts , das ein Enumerationsgeber für die Speicherbereiche ist, in denen sich Objekte im verwalteten Heap befinden.

Bemerkungen

Vor dem Aufrufen der ICorDebugProcess5::EnumerateHeapRegions Methode sollten Sie die ICorDebugProcess5::GetGCHeapInformation-Methode aufrufen und den Wert des areGCStructuresValid Felds des zurückgegebenen COR_HEAPINFO-Objekts untersuchen, um sicherzustellen, dass der Heap der Garbage Collection im aktuellen Zustand aufgezählt werden kann. Darüber hinaus gibt die ICorDebugProcess5::EnumerateHeapRegions Methode zurück E_FAIL , wenn Sie zu früh in der Lebensdauer des Prozesses anfügen, bevor Speicherbereiche erstellt werden.

Diese Methode wird garantiert alle Speicherbereiche aufzählen, die verwaltete Objekte enthalten können, aber nicht garantiert, dass verwaltete Objekte tatsächlich in diesen Regionen gespeichert sind. Das ICorDebugHeapSegmentEnum-Auflistungsobjekt kann leere oder reservierte Speicherbereiche enthalten.

Das ICorDebugHeapSegmentEnum-Schnittstellenobjekt ist ein standardenumerator, der von der ICorDebugEnum-Schnittstelle abgeleitet ist, mit der Sie COR_SEGMENT Objekte aufzählen können. Jedes COR_SEGMENT-Objekt stellt Informationen zum Speicherbereich eines bestimmten Segments zusammen mit der Generierung der Objekte in diesem Segment bereit.

Anforderungen

Plattformen: Siehe .NET unterstützte Betriebssysteme.

Kopfball: CorDebug.idl, CorDebug.h

Bibliothek: CorGuids.lib

.NET-Versionen: Verfügbar seit .NET Framework 4.5

Siehe auch

• ICorDebugProcess5-Schnittstelle