GetThreadContext-Funktion (processthreadsapi.h)

  • Artikel

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

Siehe auch