COR_HEAPOBJECT Struktur

Stellt Informationen zu einem Objekt im verwalteten Heap bereit.

Syntax

typedef struct _COR_HEAPOBJECT {
    CORDB_ADDRESS address;
    ULONG64 size;
    COR_TYPEID type;
} COR_HEAPOBJECT;

Elemente

Mitglied	Description
address	Die Adresse des Objekts im Arbeitsspeicher.
size	Die Gesamtgröße des Objekts in Byte.
type	Ein COR_TYPEID-Token , das den Typ des Objekts darstellt.

Bemerkungen

COR_HEAPOBJECT Instanzen können durch Aufzählen eines ICorDebugHeapEnum-Schnittstellenobjekts abgerufen werden, das durch Aufrufen der ICorDebugProcess5::EnumerateHeap-Methode aufgefüllt wird.

Eine COR_HEAPOBJECT Instanz stellt Informationen zu einem Liveobjekt auf dem verwalteten Heap oder über ein Objekt bereit, das von keinem Objekt verwurzelt ist, aber noch nicht vom Garbage Collector erfasst wurde.

Für eine bessere Leistung ist das COR_HEAPOBJECT.address Feld ein CORDB_ADDRESS Wert anstelle des ICorDebugValue-Schnittstellenwerts, der in einem Großteil der Debug-API verwendet wird. Um ein ICorDebugValue-Objekt für eine angegebene Objektadresse abzurufen, können Sie den CORDB_ADDRESS Wert an die ICorDebugProcess5::GetObject-Methode übergeben.

Für eine bessere Leistung ist das COR_HEAPOBJECT.type Feld ein COR_TYPEID Wert anstelle des ICorDebugType-Schnittstellenwerts, der in einem Großteil der Debug-API verwendet wird. Um ein ICorDebugType-Objekt für eine bestimmte Typ-ID abzurufen, können Sie den COR_TYPEID Wert an die ICorDebugProcess5::GetTypeForTypeID-Methode übergeben.

Die COR_HEAPOBJECT Struktur enthält eine referenzierte COM-Schnittstelle. Wenn Sie eine COR_HEAPOBJECT Instanz aus dem Enumerator abrufen, indem Sie die ICorDebugHeapEnum::Next-Methode aufrufen, müssen Sie den Verweis anschließend freigeben.

Anforderungen

Plattformen: Siehe .NET unterstützte Betriebssysteme.

Kopfball: CorDebug.idl, CorDebug.h

Bibliothek: CorGuids.lib

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