Freigeben über


GetThreadContext-Funktion (processthreadsapi.h)

Ruft den Kontext des angegebenen Threads ab.

Eine 64-Bit-Anwendung kann den Kontext eines WOW64-Threads mithilfe des 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. Der Handle muss über THREAD_GET_CONTEXT Zugriff auf den Thread verfügen. Weitere Informationen finden Sie unter Thread Security and Access Rights.

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 Member dieser Struktur gibt an, welche Teile des Kontexts eines Threads abgerufen werden. Die CONTEXT Struktur ist hochprozessorspezifisch. Informationen zu prozessorspezifischen Definitionen dieser Strukturen und allen Ausrichtungsanforderungen finden Sie in der Headerdatei "WinNT.h".

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.

Wenn die Funktion fehlschlägt, ist der Rückgabewert null. Rufen Sie GetLastErrorauf, um erweiterte Fehlerinformationen zu erhalten.

Bemerkungen

Diese Funktion wird verwendet, um den Threadkontext des angegebenen Threads abzurufen. Die Funktion ruft einen selektiven Kontext basierend auf dem Wert des ContextFlags Member der Kontextstruktur ab. Der vom hThread- Parameter identifizierte Thread wird in der Regel gedebuggt, die Funktion kann jedoch auch ausgeführt werden, wenn der Thread nicht gedebuggt wird.

Sie können keinen gültigen Kontext für einen ausgeführten Thread abrufen. Verwenden Sie die funktion SuspendThread, 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
mindestens unterstützte Client- Windows XP [Desktop-Apps | UWP-Apps]
mindestens unterstützte Server- Windows Server 2003 [Desktop-Apps | UWP-Apps]
Zielplattform- Fenster
Header- processthreadsapi.h (include Windows.h)
Library Kernel32.lib
DLL- Kernel32.dll

Siehe auch