SetThreadContext 関数 (processthreadsapi.h)

2025-06-18

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

注

64 ビットアプリケーションでは、 Wow64SetThreadContext 関数を使用して WOW64 スレッドのコンテキストを設定できます。

構文

BOOL SetThreadContext(
  [in] HANDLE        hThread,
  [in] const CONTEXT *lpContext
);

パラメーター

[in] hThread

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

[in] lpContext

指定したスレッドで設定するコンテキストを含む CONTEXT 構造体へのポインター。この構造体の ContextFlags メンバーの値は、設定するスレッドのコンテキストの部分を指定します。 指定できない CONTEXT 構造体の一部の値は、正しい値に自動的に設定されます。これには、特権プロセッサモードを指定する CPU 状態レジスタのビット、デバッグレジスタのグローバル有効化ビット、およびオペレーティングシステムによって制御される必要があるその他の状態が含まれます。

戻り値

コンテキストが設定されている場合、戻り値は 0 以外です。

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

注釈

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

実行中のスレッドのコンテキストを設定しないでください。結果は予測できません。 SuspendThread 関数を使用して、SetThreadContext を呼び出す前にスレッドを中断します。

要求事項

要件	価値
サポートされる最小クライアント	Windows XP (デスクトップアプリのみ)
サポートされている最小のサーバー	Windows Server 2003 (デスクトップアプリのみ)
ターゲットプラットフォームの	ウィンドウズ
ヘッダー	processthreadsapi.h (Windows.h を含む)
図書館	カーネル32.lib
DLL	Kernel32.dll