Wow64SetThreadContext-Funktion (wow64apiset.h)

Legt den Kontext des angegebenen WOW64-Threads fest.

Syntax

BOOL Wow64SetThreadContext(
  [in] HANDLE              hThread,
  [in] const WOW64_CONTEXT *lpContext
);

Die Parameter

[in] hThread

Ein Handle für den Thread, dessen Kontext festgelegt werden soll.

[in] 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

Mit dieser Funktion kann der selektive Kontext basierend auf dem Wert des ContextFlags-Elements der Kontextstruktur festgelegt werden. Das vom hThread-Parameter identifizierte Threadhandle wird in der Regel gedebuggt, aber die Funktion kann auch ausgeführt werden, wenn sie nicht gedebuggt wird.

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 SetThreadContext-Funktion .

Versuchen Sie nicht, den Kontext für einen ausgeführten Thread festzulegen; die Ergebnisse sind unvorhersehbar. Verwenden Sie die Wow64SuspendThread-Funktion , um den Thread anzusetzen, bevor Sie Wow64SetThreadContext aufrufen.

Anforderungen

Siehe auch

Debugfunktionen

GetXStateFeaturesMask

SetThreadContext-

SetXStateFeaturesMask-

WOW64_CONTEXT

Wow64GetThreadContext-