IDebugThread2

Artigo
05/17/2015

Essa interface representa um segmento executado em um programa.

IDebugThread2 : IUnknown

Observações para Implementadores

O mecanismo de depuração (DE) implementa essa interface para representar um segmento de execução em um único programa.

Observações para chamadores

Chame IDebugStackFrame2::GetThread para obter essa interface que representa o segmento ativo no momento.

Essa interface também é usada na criação de uma solicitação do ponto de interrupção (consulte BP_REQUEST_INFO).

Essa interface também é retornada ao resolver um ponto de interrupção ligado ou erro (consulte BP_RESOLUTION_INFO e BP_ERROR_RESOLUTION_INFO).

Métodos na ordem de Vtable

A tabela a seguir mostra os métodos de IDebugThread2.

Método	Descrição
IDebugThread2::EnumFrameInfo	Recupera uma lista dos quadros de pilha para este segmento.
IDebugThread2::GetName	Obtém o nome do segmento.
IDebugThread2::SetThreadName	Define o nome do segmento.
IDebugThread2::GetProgram	Obtém o programa no qual um thread está sendo executado.
IDebugThread2::CanSetNextStatement	Determina se a próxima instrução pode ser definida para o contexto de quadro e o código de pilha determinado.
IDebugThread2::SetNextStatement	Define a próxima instrução para o contexto de quadro e o código de pilha determinado.
IDebugThread2::GetThreadId	Obtém o identificador de segmento do sistema.
IDebugThread2::Suspend	Suspende um thread.
IDebugThread2::Resume	Retoma um thread.
IDebugThread2::GetThreadProperties	Obtém as propriedades que descrevem um thread.
IDebugThread2::GetLogicalThread	Obtém o thread lógico associado a este segmento físico.

Comentários

Como um único segmento físico pode ser executado em vários programas, mais de um IDebugThread2 de mais de um programa pode representar o mesmo segmento físico.

Quando um ponto de interrupção ou exceção ocorre, um evento é enviado, chamando IDebugEventCallback2::Event. Um dos argumentos para esse método é um IDebugThread2 interface que representa o segmento atual. IDebugThread2::EnumFrameInfoé usado para obter o IDebugStackFrame2 interface para o quadro de pilha atual.