ResumeThread 関数 (processthreadsapi.h)

  • [アーティクル]

スレッドの中断数をデクリメントします。 中断カウントが 0 にデクリメントされると、スレッドの実行が再開されます。

構文

DWORD ResumeThread(
  [in] HANDLE hThread
);

パラメーター

[in] hThread

再起動するスレッドへのハンドル。

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

戻り値

関数が成功した場合、戻り値はスレッドの以前の中断カウントです。

関数が失敗した場合、戻り値は (DWORD) -1 になります。 詳細なエラー情報を得るには、GetLastError を呼び出します。

解説

ResumeThread 関数は、サブジェクト スレッドの中断カウントを確認します。 中断回数が 0 の場合、スレッドは現在中断されていません。 それ以外の場合、サブジェクト スレッドの中断カウントはデクリメントされます。 結果の値が 0 の場合、サブジェクト スレッドの実行が再開されます。

戻り値が 0 の場合、指定されたスレッドは中断されませんでした。 戻り値が 1 の場合、指定されたスレッドは中断されましたが、再起動されました。 戻り値が 1 より大きい場合でも、指定されたスレッドは中断されます。

デバッグ イベントのレポート中に、レポート プロセス内のすべてのスレッドが固定されることに注意してください。 デバッガーでは、 SuspendThread 関数と ResumeThread 関数を使用して、プロセス内で実行できるスレッドのセットを制限する必要があります。 デバッグ イベントを報告するスレッドを除き、プロセス内のすべてのスレッドを中断することで、1 つのスレッドを "シングル ステップ" できます。 他のスレッドは、中断されている場合、続行操作によって解放されません。

Windows Phone 8.1: この関数は、Windows Phone 8.1 以降のWindows Phone ストア アプリでサポートされています。

Windows 8.1とWindows Server 2012 R2: この関数は、Windows 8.1、Windows Server 2012 R2 以降の Windows ストア アプリでサポートされています。

要件

要件 値
サポートされている最小のクライアント Windows XP [デスクトップ アプリ | UWP アプリ]
サポートされている最小のサーバー Windows Server 2003 [デスクトップ アプリのみ | UWP アプリ]
対象プラットフォーム Windows
ヘッダー processthreadsapi.h (Windows Server 2003、Windows Vista、Windows 7、Windows Server 2008 Windows Server 2008 R2 の Windows.h を含む)
Library Kernel32.lib;Windows Phone 8.1 の WindowsPhoneCore.lib
[DLL] Kernel32.dll;Windows Phone 8.1 での KernelBase.dll

こちらもご覧ください

OpenThread

プロセス関数とスレッド関数

SuspendThread

スレッド実行の中断

スレッド