IDebugThread2IDebugThread2

Cette interface représente un thread en cours d’exécution dans un programme.This interface represents a thread running in a program.

SyntaxeSyntax

IDebugThread2 : IUnknown  

Notes pour les implémenteursNotes for Implementers

Le moteur de débogage (DE) implémente cette interface pour représenter un thread d’exécution dans un seul programme.The debug engine (DE) implements this interface to represent a thread of execution in a single program.

Remarques pour les appelantsNotes for Callers

Appelez GetThread pour obtenir cette interface qui représente le thread actif.Call GetThread to obtain this interface representing the currently active thread.

Cette interface est également utilisée pour la création d’une demande de point d’arrêt (consultez BP_REQUEST_INFO).This interface is also used in creating a breakpoint request (see BP_REQUEST_INFO).

Cette interface est également renvoyée lors de la résolution d’un point d’arrêt limite ou erreur (voir BP_RESOLUTION_INFO et BP_ERROR_RESOLUTION_INFO).This interface is also returned when resolving a bound or error breakpoint (see BP_RESOLUTION_INFO and BP_ERROR_RESOLUTION_INFO).

Méthodes dans l'ordre VtableMethods in Vtable Order

Le tableau suivant présente les méthodes de IDebugThread2.The following table shows the methods of IDebugThread2.

MéthodeMethod DescriptionDescription
EnumFrameInfoEnumFrameInfo Récupère une liste des frames de pile pour ce thread.Retrieves a list of the stack frames for this thread.
GetNameGetName Obtient le nom du thread.Gets the name of the thread.
SetThreadNameSetThreadName Définit le nom du thread.Sets the name of the thread.
GetProgramGetProgram Obtient le programme dans lequel un thread est en cours d’exécution.Gets the program in which a thread is running.
CanSetNextStatementCanSetNextStatement Détermine si l’instruction suivante peut être définie dans le contexte de frame et le code de pile donné.Determines whether the next statement can be set to the given stack frame and code context.
SetNextStatementSetNextStatement Définit l’instruction suivante dans le contexte de frame et le code de pile donné.Sets the next statement to the given stack frame and code context.
GetThreadIdGetThreadId Obtient l’identificateur du thread système.Gets the system thread identifier.
SuspendSuspend Interrompt un thread.Suspends a thread.
ResumeResume Reprend un thread.Resumes a thread.
GetThreadPropertiesGetThreadProperties Obtient les propriétés qui décrivent un thread.Gets properties that describe a thread.
GetLogicalThreadGetLogicalThread Obtient le thread logique associé à ce thread physique.Gets the logical thread associated with this physical thread.

NotesRemarks

Comme un thread physique unique peut s’exécuter dans plusieurs programmes, plusieurs IDebugThread2 à partir de plusieurs programmes peuvent représenter le même thread physique.Because a single physical thread can run in multiple programs, more than one IDebugThread2 from more than one program can represent the same physical thread.

Lorsqu’un point d’arrêt ou une exception se produit, un événement est envoyé en appelant événement.When a breakpoint or exception occurs, an event is sent by calling Event. Un des arguments de cette méthode est un IDebugThread2 interface qui représente le thread actuel.One of the arguments to this method is an IDebugThread2 interface representing the current thread. EnumFrameInfo permet d’obtenir le IDebugStackFrame2 interface pour le frame de pile actuel.EnumFrameInfo is used to obtain the IDebugStackFrame2 interface for the current stack frame.

SpécificationsRequirements

En-tête : msdbg.hHeader: msdbg.h

Namespace : Microsoft.VisualStudio.Debugger.InteropNamespace: Microsoft.VisualStudio.Debugger.Interop

Assembly : Microsoft.VisualStudio.Debugger.Interop.dllAssembly: Microsoft.VisualStudio.Debugger.Interop.dll

Voir aussiSee Also

Interfaces de base Core Interfaces
Événement Event
GetThread GetThread
BP_REQUEST_INFO BP_REQUEST_INFO
BP_RESOLUTION_INFO BP_RESOLUTION_INFO
BP_ERROR_RESOLUTION_INFOBP_ERROR_RESOLUTION_INFO