SetThreadContext-Funktion (processthreadsapi.h)

Artikel
08/25/2023

Legt den Kontext für den angegebenen Thread fest.

Eine 64-Bit-Anwendung kann den Kontext eines WOW64-Threads mithilfe der Wow64SetThreadContext-Funktion festlegen.

Syntax

BOOL SetThreadContext(
  [in] HANDLE        hThread,
  [in] const CONTEXT *lpContext
);

Parameter

[in] hThread

Ein Handle für den Thread, dessen Kontext festgelegt werden soll. Das Handle muss über das THREAD_SET_CONTEXT Zugriffsrecht auf den Thread verfügen. Weitere Informationen finden Sie unter Threadsicherheit und Zugriffsrechte.

[in] lpContext

Ein Zeiger auf eine CONTEXT-Struktur , die den kontext enthält, der im angegebenen Thread festgelegt werden soll. Der Wert des ContextFlags-Elements dieser Struktur gibt an, welche Teile des Kontexts eines Threads festgelegt werden sollen. Einige Werte in der CONTEXT-Struktur , die nicht angegeben werden können, werden automatisch auf den richtigen Wert festgelegt. Dies umfasst Bits im CPU-status Register, die den privilegierten Prozessormodus angeben, globale Aktivierungsbits im Debugregister und andere Zustände, die vom Betriebssystem gesteuert werden müssen.

Rückgabewert

Wenn der Kontext festgelegt wurde, ist der Rückgabewert ungleich null.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

Die Funktion legt den Threadkontext basierend auf dem Wert des ContextFlags-Elements der Kontextstruktur fest. Der durch den hThread-Parameter identifizierte Thread wird in der Regel gedebuggt, aber die Funktion kann auch dann ausgeführt werden, wenn der Thread nicht gedebuggt wird.

Versuchen Sie nicht, den Kontext für einen ausgeführten Thread festzulegen. die Ergebnisse sind unvorhersehbar. Verwenden Sie die SuspendThread-Funktion , um den Thread vor dem Aufruf von SetThreadContext anzusetzen.

Anforderungen


Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	processthreadsapi.h (include Windows.h)
Bibliothek	Kernel32.lib
DLL	Kernel32.dll