Partilhar via

Método ICorDebugProcess5::EnumerateHeap

  • Artigo

Obtém um enumerador para os objetos na área dinâmica para dados gerida.

Sintaxe

HRESULT EnumerateHeap(  
    [out] ICorDebugHeapEnum **ppObjects  
);

Parâmetros

ppObject
[fora] Um ponteiro para o endereço de um objeto de interface ICorDebugHeapEnum que é um enumerador para os objetos que residem na área dinâmica para dados gerida.

Observações

Antes de chamar o ICorDebugProcess5::EnumerateHeap método , deve chamar o método ICorDebugProcess5::GetGCHeapInformation e examinar o valor do areGCStructuresValid campo do objeto COR_HEAPINFO devolvido para garantir que a área dinâmica para dados de libertação da memória no seu estado atual é enumerada. Além disso, o ICorDebugProcess5::EnumerateHeap devolve E_FAIL se anexar demasiado cedo na duração do processo, antes de a memória da área dinâmica para dados gerida ser alocada.

O objeto de interface ICorDebugHeapEnum é um enumerador padrão derivado da interface ICorDebugEnum que lhe permite enumerar COR_HEAPOBJECT objetos. Este método preenche o objeto de coleção ICorDebugHeapEnum com COR_HEAPOBJECT instâncias que fornecem informações sobre todos os objetos. A coleção também pode incluir COR_HEAPOBJECT instâncias que fornecem informações sobre objetos que não estão enraizados por qualquer objeto, mas que ainda não foram recolhidos pelo recoletor de lixo.

Requisitos

Plataformas: Veja Requisitos de Sistema.

Cabeçalho: CorDebug.idl, CorDebug.h

Biblioteca: CorGuids.lib

.NET Framework Versões: Disponível desde a versão 4.5

Ver também