IDebugBreakpoint::SetMatchThreadId-Methode (dbgeng.h)

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 Prozessorhaltepunkt. Prozessorhaltepunkte 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 Haltepunkteigenschaften finden Sie unter Steuern von Breakpointflags und -parametern.

Anforderungen

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