Struttura COR_GC_REFERENCECOR_GC_REFERENCE Structure

Contiene informazioni su on oggetto da sottoporre a Garbage Collection.Contains information about an object that is to be garbage-collected.

SintassiSyntax

typedef struct _COR_GC_REFERENCE {  
    ICorDebugAppDomain *domain;   
    ICorDebugValue *location;  
    CorGCReferenceType type;  
    UINT64 extraData;  
} COR_GC_REFERENCE;  

MembriMembers

MembroMember DescrizioneDescription
domain Puntatore al dominio dell'applicazione a cui appartiene l'oggetto o handle.A pointer to the application domain to which the handle or object belongs. Il valore può essere null.Its value may be null.
location ICorDebugValue o un'interfaccia ICorDebugReferenceValue che corrisponde all'oggetto da sottoporre a garbage collection.Either an ICorDebugValue or an ICorDebugReferenceValue interface that corresponds to the object to be garbage-collected.
type Oggetto CorGCReferenceType valore di enumerazione che indica la provenienza di radice.A CorGCReferenceType enumeration value that indicates where the root came from. Per altre informazioni, vedere la sezione Osservazioni.For more information, see the Remarks section.
extraData Dati aggiuntivi sull'oggetto da sottoporre a garbage collection.Additional data about the object to be garbage-collected. Queste informazioni dipendono dall'origine dell'oggetto, come indicato dal type campo.This information depends on the source of the object, as indicated by the type field. Per altre informazioni, vedere la sezione Osservazioni.For more information, see the Remarks section.

NoteRemarks

Il type campo è un CorGCReferenceType valore di enumerazione che indica la provenienza di riferimento.The type field is a CorGCReferenceType enumeration value that indicates where the reference came from. Un particolare COR_GC_REFERENCE valore riflette uno qualsiasi dei seguenti tipi di oggetti gestiti:A particular COR_GC_REFERENCE value can reflect any of the following kinds of managed objects:

  • Gli oggetti da tutti gli stack gestiti (CorGCReferenceType.CorReferenceStack).Objects from all managed stacks (CorGCReferenceType.CorReferenceStack). Questo include i riferimenti in tempo reale in codice gestito, come gli oggetti creati da common language runtime.This includes live references in managed code, as well as objects created by the common language runtime.

  • Gli oggetti dalla tabella di handle (CorGCReferenceType.CorHandle*).Objects from the handle table (CorGCReferenceType.CorHandle*). Sono inclusi riferimenti forti (HNDTYPE_STRONG e HNDTYPE_REFCOUNT) e le variabili statiche in un modulo.This includes strong references (HNDTYPE_STRONG and HNDTYPE_REFCOUNT) and static variables in a module.

  • Gli oggetti dalla coda del finalizzatore (CorGCReferenceType.CorReferenceFinalizer).Objects from the finalizer queue (CorGCReferenceType.CorReferenceFinalizer). Coda del finalizzatore radici di oggetti fino a quando non è stato eseguito il finalizzatore.The finalizer queue roots objects until the finalizer has run.

Il extraData campo contiene dati aggiuntivi a seconda di origine (o) del riferimento.The extraData field contains extra data depending on the source (or type) of the reference. I possibili valori sono:Possible values are:

  • DependentSource.DependentSource. Se il type è CorGCREferenceType.CorHandleStrongDependent, questo campo è l'oggetto che, se è attivo, le radici di oggetto per essere sottoposto a garbage collection in COR_GC_REFERENCE.Location.If the type is CorGCREferenceType.CorHandleStrongDependent, this field is the object that, if alive, roots the object to be garbage-collected at COR_GC_REFERENCE.Location.

  • RefCount.RefCount. Se il type è CorGCREferenceType.CorHandleStrongRefCount, questo campo è il conteggio dei riferimenti dell'handle.If the type is CorGCREferenceType.CorHandleStrongRefCount, this field is the reference count of the handle.

  • Size.Size. Se il type è CorGCREferenceType.CorHandleStrongSizedByref, questo campo è alle ultime dimensioni dell'albero degli oggetti per cui il garbage collector calcolato le radici di oggetto.If the type is CorGCREferenceType.CorHandleStrongSizedByref, this field is the last size of the object tree for which the garbage collector calculated the object roots. Si noti che questo calcolo non è necessariamente aggiornato.Note that this calculation is not necessarily up to date.

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