Partilhar 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 [saídas] 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 pilha representa a pilha de chamada física 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 mudança de contexto.

  • Um sequestro do depurador de um thread de usuário.

No caso simples de um thread que está executando código puramente gerenciado em um único contexto, existirá uma correspondência um-para-um 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 classificar todas as cadeias dos fios por suas relações chamador/destinatário e reagrupá-las.

Requisitos

Plataformas: Consulte Requisitos do sistema.

Cabeçalho: CorDebug.idl, CorDebug.h

Biblioteca: CorGuids.lib

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