SetThreadContext-Funktion (processthreadsapi.h)
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 |