ICorDebugProcess5::EnumerateHeap-Methode
Ruft einen Enumerator für die Objekte auf dem verwalteten Heap auf.
Syntax
HRESULT EnumerateHeap(
[out] ICorDebugHeapEnum **ppObjects
);
Parameter
ppObject [out] Ein Zeiger auf die Adresse eines ICorDebugHeapEnum-Schnittstellenobjekts , das ein Enumerator für die Objekte ist, die sich im verwalteten Heap befinden.
Hinweise
Bevor Sie die ICorDebugProcess5::EnumerateHeap-Methode aufrufen, sollten Sie die ICorDebugProcess5::GetGCHeapInformation-Methode aufrufen und den Wert des areGCStructuresValid-Felds des zurückgegebenen COR_HEAPINFO-Objekts untersuchen, um sicherzustellen, dass der Garbage Collection-Heap in seinem aktuellen Zustand aufzählbar ist. Darüber hinaus gibt ICorDebugProcess5::EnumerateHeap den Wert E_FAIL zurück, wenn das Anhängen zu früh in der Lebensdauer des Prozesses erfolgt, bevor Arbeitsspeicher für den verwalteten Heap belegt wurde.
Das ICorDebugHeapEnum-Schnittstellenobjekt ist ein von der ICorDebugEnum-Schnittstelle abgeleiteter Standardenumerator, mit dem Sie COR_HEAPOBJECT-Objekte auflisten können. Diese Methode füllt das ICorDebugHeapEnum-Auflistungsobjekt mit COR_HEAPOBJECT-Instanzen auf, die Informationen zu allen Objekten bereitstellen. Die Auflistung kann auch COR_HEAPOBJECT-Instanzen mit Informationen zu Objekten enthalten, die für kein Objekt als Stamm festgelegt, aber noch nicht vom Garbage Collector erfasst wurden.
Anforderungen
Plattformen: Informationen finden Sie unter Systemanforderungen.
Header: CorDebug.idl, CorDebug.h
Bibliothek: CorGuids.lib
.NET Framework-Versionen: Seit Version 4.5 verfügbar
