IDebugSystemObjects3::SetImplicitThreadDataOffset-Methode (dbgeng.h)

Die SetImplicitThreadDataOffset-Methode legt den impliziten Thread für den aktuellen Prozess fest.

Syntax

HRESULT SetImplicitThreadDataOffset(
  [in] ULONG64 Offset
);

Parameter

[in] Offset

Gibt den Speicherort im Speicheradressraum des Ziels der Datenstruktur des Systemthreads an, der zum impliziten Thread für den aktuellen Prozess werden soll. Wenn dies 0 ist, wird der implizite Thread für den aktuellen Prozess auf den impliziten Standardthread festgelegt.

Rückgabewert

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

Rückgabecode	BESCHREIBUNG
S_OK	Die Methode war erfolgreich.

Hinweise

Beim Debuggen im Kernelmodus ist die Datenstruktur die KTHREAD-Struktur für den Prozess.

Beim Debuggen im Benutzermodus ist die Datenstruktur der Threadumgebungsblock (TEB) für den Prozess.

Warnung Da es möglich ist , SetImplicitProcessDataOffset zu verwenden, um den impliziten Prozess unabhängig vom impliziten Thread festzulegen, gehört der implizite Thread möglicherweise nicht zum impliziten Prozess. Dies kann Fehler verursachen, wenn Sie versuchen, auf einen der Benutzerzustände für den impliziten Thread zuzugreifen, da er mit dem virtuellen Adressraum (durch den impliziten Prozess angegeben) nicht kompatibel ist.

 

Weitere Informationen zum aktuellen impliziten Thread finden Sie unter Threads und Prozesse. Ausführliche Informationen zur KTHREAD-Struktur und zur TEB finden Sie unter Microsoft Windows Internals von David Solomon und Mark Russinovich.

Anforderungen

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