IDebugBreakpoint2::SetMatchThreadId-Methode (dbgeng.h)

  • Artikel

Die SetMatchThreadId-Methode legt die Enginethread-ID des Threads fest, der einen Haltepunkt auslösen kann.

Syntax

HRESULT SetMatchThreadId(
  [in] ULONG Thread
);

Parameter

[in] Thread

Die Enginethread-ID des Threads, der diesen Haltepunkt auslösen kann.

Rückgabewert

Rückgabecode BESCHREIBUNG
S_OK
 Die Methode war erfolgreich.
E_NOINTERFACE
 Der Thread, den Thread angibt, konnte nicht gefunden werden.
E_INVALIDARG
 Das Ziel befindet sich in einem Kernel, und der Haltepunkt ist ein Prozessor breakpoint. Prozessor breakpoints können nicht auf Threads im Kernelmodus beschränkt werden.
 

Diese Methode kann auch andere Fehlerwerte zurückgeben. Weitere Informationen finden Sie unter Rückgabewerte.

Hinweise

Wenn Sie einen Thread für den Haltepunkt festgelegt haben, kann der Haltepunkt nur ausgelöst werden, wenn dieser Thread den Haltepunkt erreicht. Wenn Sie keinen Thread festgelegt haben, kann jeder Thread den Haltepunkt auslösen.

Wenn Sie einen Thread festgelegt haben, können Sie die Einstellung entfernen, indem Sie id auf DEBUG_ANY_ID festlegen.

Weitere Informationen zu Breakpointeigenschaften finden Sie unter Steuern von Breakpointflags und -parametern.

Anforderungen

Anforderung Wert
Zielplattform Desktop
Kopfzeile dbgeng.h (einschließlich Dbgeng.h)