次の方法で共有

GetThreadContext 関数 (processthreadsapi.h)

  • [アーティクル]

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

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

構文

BOOL GetThreadContext(
  [in]      HANDLE    hThread,
  [in, out] LPCONTEXT lpContext
);

パラメーター

[in] hThread

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

Windows XP または Windows Server 2003: ハンドルにも THREAD_QUERY_INFORMATION アクセス権が必要です。

[in, out] lpContext

指定したスレッドの適切なコンテキストを受け取る CONTEXT 構造体 (ARM64_NT_CONTEXTなど) へのポインター。 この構造体の ContextFlags メンバーの値は、スレッドのコンテキストのどの部分を取得するかを指定します。 CONTEXT 構造体は、高度なプロセッサ固有です。 この構造体のプロセッサ固有の定義とアラインメント要件については、WinNT.h ヘッダー ファイルを参照してください。

戻り値

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

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

備考

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

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

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

必要条件

要件 価値
サポートされる最小クライアント Windows XP [デスクトップ アプリ |UWP アプリ]
サポートされる最小サーバー Windows Server 2003 [デスクトップ アプリ |UWP アプリ]
ターゲット プラットフォーム の ウィンドウズ
ヘッダー processthreadsapi.h (Windows.h を含む)
ライブラリ Kernel32.lib
DLL Kernel32.dll

関連項目