ResetEvent 関数 (synchapi.h)

指定したイベントオブジェクトを非署名状態に設定します。

構文

BOOL ResetEvent(
  [in] HANDLE hEvent
);

[in] hEvent

イベントオブジェクトへのハンドル。 CreateEvent 関数または OpenEvent 関数は、このハンドルを返します。

ハンドルには、EVENT_MODIFY_STATEアクセス権が必要です。詳細については、「同期オブジェクトのセキュリティとアクセス権」を参照してください。

関数が成功すると、戻り値は 0 以外になります。

関数が失敗した場合は、0 を返します。詳細なエラー情報を得るには、GetLastError を呼び出します。

イベントオブジェクトの状態は、 SetEvent 関数または PulseEvent 関数によって明示的にシグナルに設定されるまで、非署名のままです。この非割り当て状態は、待機関数の 1 つの呼び出しでイベントオブジェクトを指定したスレッドの実行をブロックします。

ResetEvent 関数は、主に手動リセットイベントオブジェクトに使用されます。これは、非署名状態に明示的に設定する必要があります。自動リセットイベントオブジェクトは、1 つの待機スレッドが解放された後に、シグナル状態から非署名に自動的に変更されます。

既にリセットされているイベントをリセットしても影響はありません。


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