Método ICorDebugThread::EnumerateChains

  • Artigo

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

Sintaxe

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

Parâmetros

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

Comentários

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 sequestro de um depurador de um thread de usuário.

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

Talvez um depurador queira 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/computador chamado e reagrupá-las.

Requisitos

Plataformas: confira Requisitos do sistema.

Cabeçalho: CorDebug.idl, CorDebug.h

Biblioteca: CorGuids.lib

Versões do .NET Framework: Disponíveis desde a versão 1.0