Share via

ICorDebugProcess5::EnumerateHeap-Methode

  • Artikel

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 als Enumerator für die Objekte dient, die sich auf dem verwalteten Heap befinden.

Bemerkungen

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

Siehe auch