IDebugSystemObjects2::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 dieser Wert 0 ist, wird der implizite Thread für den aktuellen Prozess auf den impliziten Standardthread festgelegt.

Rückgabewert

Diese Methode gibt möglicherweise auch Fehlerwerte zurück. 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 zu Fehlern führen, wenn Sie versuchen, auf einen benutzerspezifischen Zustand für den impliziten Thread zuzugreifen, da er mit dem virtuellen Adressraum (angegeben durch den impliziten Prozess) 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 (dbgeng.h einschließen)