Wow64GetThreadContext-Funktion (wow64apiset.h)

Ruft den Kontext des angegebenen WOW64-Threads ab.

Syntax

BOOL Wow64GetThreadContext(
  [in]      HANDLE         hThread,
  [in, out] PWOW64_CONTEXT lpContext
);

Die 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.

[in, out] lpContext

Eine WOW64_CONTEXT Struktur. Der Aufrufer muss das ContextFlags-Element dieser Struktur initialisieren.

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-Elements der Kontextstruktur ab. Der vom hThread-Parameter identifizierte Thread wird in der Regel gedebuggt, aber die Funktion kann 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 Wow64SuspendThread-Funktion , um den Thread anzusetzen, bevor Sie Wow64GetThreadContext aufrufen.

Wenn Sie Wow64GetThreadContext für den aktuellen Thread aufrufen, wird die Funktion erfolgreich zurückgegeben. Der zurückgegebene Kontext ist jedoch ungültig.

Diese Funktion ist für 64-Bit-Anwendungen vorgesehen. Es wird unter 32-Bit-Windows nicht unterstützt. Solche Aufrufe schlagen fehl und legen den letzten Fehlercode auf ERROR_INVALID_FUNCTION fest. Eine 32-Bit-Anwendung kann diese Funktion in einem WOW64-Thread aufrufen; Das Ergebnis entspricht dem Aufrufen der GetThreadContext-Funktion .

Anforderungen

Siehe auch

Debugfunktionen

GetThreadContext-Funktion

GetXStateFeaturesMask

WOW64_CONTEXT

Wow64SetThreadContext-