GetThreadContext-Funktion (processthreadsapi.h)
Ruft den Kontext des angegebenen Threads ab.
Eine 64-Bit-Anwendung kann den Kontext eines WOW64-Threads mithilfe von Wow64GetThreadContext abrufen.
Syntax
BOOL GetThreadContext(
[in] HANDLE hThread,
[in, out] LPCONTEXT lpContext
);
Parameter
[in] hThread
Ein Handle für den Thread, dessen Kontext abgerufen werden soll. Das Handle muss THREAD_GET_CONTEXT Zugriff auf den Thread haben. Weitere Informationen finden Sie unter Threadsicherheit und Zugriffsrechte.
Windows XP oder Windows Server 2003: Das Handle muss auch über THREAD_QUERY_INFORMATION Zugriff verfügen.
[in, out] lpContext
Ein Zeiger auf eine CONTEXT-Struktur (z. B. ARM64_NT_CONTEXT), die den entsprechenden Kontext des angegebenen Threads empfängt. Der Wert des ContextFlags-Members dieser Struktur gibt an, welche Teile des Kontexts eines Threads abgerufen werden. Die CONTEXT-Struktur ist sehr prozessorspezifisch. In der WinNT.h-Headerdatei finden Sie prozessorspezifische Definitionen dieser Strukturen und alle Ausrichtungsanforderungen.
Rückgabewert
Wenn die Funktion erfolgreich ist, 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
Diese Funktion wird verwendet, um den Threadkontext des angegebenen Threads abzurufen. Die Funktion ruft einen selektiven Kontext basierend auf dem Wert des ContextFlags-Members der Kontextstruktur ab. Der durch den hThread-Parameter identifizierte Thread wird in der Regel debuggen, aber die Funktion kann auch ausgeführt werden, wenn der Thread nicht debuggt wird.
Sie können keinen gültigen Kontext für einen ausgeführten Thread abrufen. Verwenden Sie die SuspendThread-Funktion , um den Thread anzusetzen, bevor Sie GetThreadContext aufrufen.
Wenn Sie GetThreadContext für den aktuellen Thread aufrufen, wird die Funktion erfolgreich zurückgegeben. Der zurückgegebene Kontext ist jedoch ungültig.
Anforderungen
Anforderung | Wert |
---|---|
Unterstützte Mindestversion (Client) | Windows XP [Desktop-Apps | UWP-Apps] |
Unterstützte Mindestversion (Server) | Windows Server 2003 [Desktop-Apps | UWP-Apps] |
Zielplattform | Windows |
Kopfzeile | processthreadsapi.h (einschließlich Windows.h) |
Bibliothek | Kernel32.lib |
DLL | Kernel32.dll |