IDebugBreakpoint::SetMatchThreadId-Methode (dbgeng.h)

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

Syntax

HRESULT SetMatchThreadId(
  [in] ULONG Thread
);

Parameter

[in] Thread

Die Modulthread-ID des Threads, die diesen Haltepunkt auslösen kann.

Rückgabewert

Rückgabecode	Beschreibung
S_OK	Die Methode war erfolgreich.
E_NOINTERFACE	Der Thread, der Thread- angibt, wurde nicht gefunden.
E_INVALIDARG	Das Ziel befindet sich in einem Kernel und der Haltepunkt ist ein Prozessor-Haltepunkt. Prozessor-Haltepunkte 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.

Bemerkungen

Wenn Sie einen Thread für den Haltepunkt festgelegt haben, kann der Haltepunkt nur ausgelöst werden, wenn dieser Thread auf den Haltepunkt trifft. 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 Haltepunkteigenschaften finden Sie unter Steuern von Haltepunktkennzeichnungen und Parametern.

Anforderungen

Anforderung	Wert
Zielplattform-	Desktop
Header-	dbgeng.h (include Dbgeng.h)