Wow64GetThreadContext 関数 (wow64apiset.h)

指定した WOW64 スレッドのコンテキストを取得します。

構文

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

パラメーター

[in] hThread

コンテキストを取得するスレッドへのハンドル。ハンドルには、スレッド へのTHREAD_GET_CONTEXT アクセス権が必要です。詳細については、「スレッドセキュリティとアクセス権の」を参照してください。

[in, out] lpContext

WOW64_CONTEXT構造体。呼び出し元は、この構造体の ContextFlags メンバーを初期化する必要があります。

戻り値

関数が成功した場合、戻り値は 0 以外です。

関数が失敗した場合、戻り値は 0 です。拡張エラー情報を取得するには、GetLastError呼び出します。

注釈

この関数は、指定されたスレッドのスレッドコンテキストを取得するために使用されます。この関数は、コンテキスト構造の ContextFlags メンバーの値に基づいて、選択的コンテキストを取得します。 通常、hThread パラメーターによって識別されるスレッドはデバッグ中ですが、スレッドがデバッグされていない場合にも関数を動作させることができます。

実行中のスレッドの有効なコンテキストを取得できません。 Wow64SuspendThread 関数を使用して、Wow64GetThreadContext を呼び出す前にスレッドを中断します。

現在のスレッドに 対して Wow64GetThreadContext を呼び出すと、関数は正常に返されます。ただし、返されるコンテキストは無効です。

この関数は、64 ビットアプリケーションを対象としています。 32 ビット Windows ではサポートされていません。このような呼び出しは失敗し、最後のエラーコードを ERROR_INVALID_FUNCTIONに設定します。 32 ビットアプリケーションでは、WOW64 スレッドでこの関数を呼び出すことができます。結果は、GetThreadContext 関数の呼び出しと同じです。

要求事項

要件	価値
サポートされる最小クライアント	Windows 10 バージョン 1903
サポートされている最小のサーバー	Windows Server バージョン 1903
ヘッダー	wow64apiset.h
図書館	カーネル32.lib
DLL	Kernel32.dll