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;

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 as instâncias podem ser recuperadas enumerando um objeto de interface ICorDebugHeapEnum que é preenchido chamando o método ICorDebugProcess5::EnumerateHeap .

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

Para melhorar o 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 objeto ICorDebugValue para um determinado endereço de objeto, você pode passar o CORDB_ADDRESS valor para o método ICorDebugProcess5::GetObject .

Para melhorar o 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 método ICorDebugProcess5::GetTypeForTypeID .

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

Requirements

Plataformas: Consulte sistemas operacionais com suporte do .NET.

Cabeçalho: CorDebug.idl, CorDebug.h

Biblioteca: CorGuids.lib

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