Compartilhar via


Estrutura COR_HEAPOBJECT

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

Sintaxe

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

Membros

Membro DESCRIÇÃO
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.

Comentários

As instâncias de COR_HEAPOBJECT podem ser recuperadas pela enumeração de um objeto da interface ICorDebugHeapEnum que é preenchido com uma chamada ao método ICorDebugProcess5::EnumerateHeap.

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

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

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

A estrutura COR_HEAPOBJECT inclui uma interface COM contada por referência. Se você recuperar uma instância de COR_HEAPOBJECT do enumerador chamando o método ICorDebugHeapEnum::Next, precisará liberar a referência posteriormente.

Requisitos

Plataformas: confira Requisitos do sistema.

Cabeçalho: CorDebug.idl, CorDebug.h

Biblioteca: CorGuids.lib

Versões do .NET Framework: disponíveis desde 4.5

Confira também