COR_HEAPOBJECT Estrutura

Fornece informações sobre um objeto no heap gerenciado.

Sintaxe

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

Members

Membro	Description
address	O endereço do objeto na memória.
size	O tamanho total do objeto, em bytes.
type	Um token COR_TYPEID que representa o tipo do objeto.

Observações

COR_HEAPOBJECT instâncias podem ser recuperadas enumerando um objeto de interface ICorDebugHeapEnum que é preenchido chamando o ICorDebugProcess5::EnumerateHeap método.

Uma COR_HEAPOBJECT instância fornece informações sobre um objeto dinâmico no heap gerenciado ou sobre um objeto que não está enraizado por nenhum objeto, mas ainda não foi coletado pelo coletor de lixo.

Para um melhor desempenho, o COR_HEAPOBJECT.address campo é um CORDB_ADDRESS valor em vez do valor da interface ICorDebugValue usado em grande parte da API de depuração. Para obter um ICorDebugValue objeto para um determinado endereço de objeto, você pode passar o CORDB_ADDRESS valor para o ICorDebugProcess5::GetObject método.

Para um melhor desempenho, o COR_HEAPOBJECT.type campo é um COR_TYPEID valor em vez do valor da interface ICorDebugType usado em grande parte da API de depuração. Para obter um objeto ICorDebugType para uma determinada ID de tipo, você pode passar o COR_TYPEID valor para o ICorDebugProcess5::GetTypeForTypeID método.

A COR_HEAPOBJECT estrutura inclui uma interface COM com contagem de referências. Se você recuperar uma COR_HEAPOBJECT instância do enumerador chamando o ICorDebugHeapEnum::Next método, você deve liberar subsequentemente a referência.

Requerimentos

Plataformas: Consulte Sistemas operacionais suportados pelo .NET.

Cabeçalho: CorDebug.idl, CorDebug.h

Biblioteca: CorGuids.lib

Versões .NET: Disponível desde: .NET Framework 4.5