指定したスレッドのコンテキストを設定します。
注
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 |
こちらも参照ください
GetThreadContext の
GetXStateFeaturesMask の
SetXStateFeaturesMask の