Struttura COR_HEAPOBJECTCOR_HEAPOBJECT Structure

Fornisce informazioni su un oggetto nell'heap gestito.Provides information about an object on the managed heap.

SintassiSyntax

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

MembriMembers

MembroMember DescrizioneDescription
address L'indirizzo dell'oggetto in memoria.The address of the object in memory.
size Le dimensioni totali dell'oggetto, in byte.The total size of the object, in bytes.
type Oggetto COR_TYPEID token che rappresenta il tipo dell'oggetto.A COR_TYPEID token that represents the type of the object.

NoteRemarks

COR_HEAPOBJECT le istanze possono essere recuperate tramite l'enumerazione di un ICorDebugHeapEnum oggetto dell'interfaccia che viene popolata chiamando il ICorDebugProcess5::EnumerateHeap (metodo).COR_HEAPOBJECT instances can be retrieved by enumerating an ICorDebugHeapEnum interface object that is populated by calling the ICorDebugProcess5::EnumerateHeap method.

Oggetto COR_HEAPOBJECT istanza vengono fornite informazioni su un oggetto nell'heap gestito in tempo reale o su un oggetto che non contiene una radice da qualsiasi oggetto, ma non ha ancora recuperato da garbage collector.A COR_HEAPOBJECT instance provides information either about a live object on the managed heap, or about an object that is not rooted by any object but has not yet been collected by the garbage collector.

Per ottenere prestazioni migliori, il COR_HEAPOBJECT.address campo è un CORDB_ADDRESS valore anziché l'ICorDebugValue interfaccia valore usato nella maggior parte delle API di debug.For better performance, the COR_HEAPOBJECT.address field is a CORDB_ADDRESS value rather than the ICorDebugValue interface value used in much of the debugging API. Per ottenere un oggetto ICorDebugValue per indirizzo di un determinato oggetto, è possibile passare il CORDB_ADDRESS valore per il icordebugprocess5:: GetObject metodo.To obtain an ICorDebugValue object for a given object address, you can pass the CORDB_ADDRESS value to the ICorDebugProcess5::GetObject method.

Per ottenere prestazioni migliori, il COR_HEAPOBJECT.type campo è un COR_TYPEID valore anziché l'ICorDebugType interfaccia valore usato nella maggior parte delle API di debug.For better performance, the COR_HEAPOBJECT.type field is a COR_TYPEID value rather than the ICorDebugType interface value used in much of the debugging API. Per ottenere un oggetto ICorDebugType per l'ID di un determinato tipo, è possibile passare il COR_TYPEID valore per il icordebugprocess5:: Gettypefortypeid metodo.To obtain an ICorDebugType object for a given type ID, you can pass the COR_TYPEID value to the ICorDebugProcess5::GetTypeForTypeID method.

Il COR_HEAPOBJECT struttura include un'interfaccia COM con conteggio dei riferimenti.The COR_HEAPOBJECT structure includes a reference-counted COM interface. Se si recupera un COR_HEAPOBJECT istanza dell'enumeratore chiamando il icordebugheapenum:: Next (metodo), successivamente è necessario rilasciare il riferimento.If you retrieve a COR_HEAPOBJECT instance from the enumerator by calling the ICorDebugHeapEnum::Next method, you must subsequently release the reference.

RequisitiRequirements

Piattaforme: vedere requisiti di sistema.Platforms: See System Requirements.

Intestazione: Cordebug. idl, Cordebug. HHeader: CorDebug.idl, CorDebug.h

Libreria: CorGuids. libLibrary: CorGuids.lib

Versioni di .NET framework: Disponibile dalla 4.5Available since 4.5.NET Framework Versions: Disponibile dalla 4.5Available since 4.5

Vedere ancheSee Also

Strutture di debugDebugging Structures
DebugDebugging