COR_HEAPOBJECT, structureCOR_HEAPOBJECT Structure

Fournit des informations à propos d’un objet sur le tas managé.Provides information about an object on the managed heap.

SyntaxeSyntax

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

MembresMembers

MembreMember DescriptionDescription
address L’adresse de l’objet en mémoire.The address of the object in memory.
size La taille totale de l’objet, en octets.The total size of the object, in bytes.
type Un COR_TYPEID jeton qui représente le type de l’objet.A COR_TYPEID token that represents the type of the object.

NotesRemarks

COR_HEAPOBJECT instances peuvent être récupérées en énumérant un ICorDebugHeapEnum objet d’interface qui est remplie en appelant le ICorDebugProcess5::EnumerateHeap (méthode).COR_HEAPOBJECT instances can be retrieved by enumerating an ICorDebugHeapEnum interface object that is populated by calling the ICorDebugProcess5::EnumerateHeap method.

Un COR_HEAPOBJECT instance fournit des informations sur un objet dynamique sur le tas managé, ou sur un objet qui est associé à aucune racine par n’importe quel objet, mais n’a pas encore été collecté par le 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.

Pour de meilleures performances, le COR_HEAPOBJECT.address champ est un CORDB_ADDRESS valeur plutôt que ICorDebugValue interface valeur utilisée dans une grande partie de l’API de débogage.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. Pour obtenir un objet ICorDebugValue pour une adresse de l’objet donné, vous pouvez passer le CORDB_ADDRESS valeur pour le ICorDebugProcess5::GetObject (méthode).To obtain an ICorDebugValue object for a given object address, you can pass the CORDB_ADDRESS value to the ICorDebugProcess5::GetObject method.

Pour de meilleures performances, le COR_HEAPOBJECT.type champ est un COR_TYPEID valeur plutôt que de ICorDebugType interface valeur utilisée dans une grande partie de l’API de débogage.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. Pour obtenir un objet ICorDebugType à un ID de type donné, vous pouvez passer le COR_TYPEID valeur pour le ICorDebugProcess5::GetTypeForTypeID (méthode).To obtain an ICorDebugType object for a given type ID, you can pass the COR_TYPEID value to the ICorDebugProcess5::GetTypeForTypeID method.

Le COR_HEAPOBJECT structure inclut une interface COM contenant des références.The COR_HEAPOBJECT structure includes a reference-counted COM interface. Si vous récupérez un COR_HEAPOBJECT instance à partir de l’énumérateur en appelant le ICorDebugHeapEnum::Next (méthode), vous devez libérer par la suite de la référence.If you retrieve a COR_HEAPOBJECT instance from the enumerator by calling the ICorDebugHeapEnum::Next method, you must subsequently release the reference.

Configuration requiseRequirements

Plateformes : Consultez Configuration requise.Platforms: See System Requirements.

En-tête : CorDebug.idl, CorDebug.hHeader: CorDebug.idl, CorDebug.h

Bibliothèque : CorGuids.libLibrary: CorGuids.lib

Versions du .NET Framework : Disponible à partir de 4.5Available since 4.5.NET Framework Versions: Disponible à partir de 4.5Available since 4.5

Voir aussiSee also