Compartilhar via


Método ICorDebugThread::EnumerateChains

Obtém um ponteiro de interface para um enumerador ICorDebugChainEnum que contém todas as cadeias de pilha neste objeto ICorDebugThread.

Sintaxe

HRESULT EnumerateChains (
    [out] ICorDebugChainEnum **ppChains
);

Parâmetros

ppChains [out] Um ponteiro para o endereço de um ICorDebugChainEnum objeto que permite a enumeração de todas as cadeias de pilha neste thread, começando na cadeia ativa (ou seja, a mais recente).

Observações

A cadeia de pilhas representa a pilha de chamadas físicas para o thread. As seguintes circunstâncias criam um limite de cadeia de pilha:

  • Uma transição gerenciada para não gerenciada ou não gerenciada para gerenciada.

  • Uma opção de contexto.

  • Um depurador que sequestra um thread de usuário.

No caso simples de um thread que esteja executando código puramente gerenciado em um único contexto, uma correspondência um-para-um existirá entre threads e cadeias de pilha.

Um depurador pode querer reorganizar as pilhas de chamadas físicas de todos os threads em pilhas de chamadas lógicas. Isso envolveria a classificação de todas as cadeias de threads por suas relações de chamador/receptor e reagrupá-las.

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 1.0