WSACreateEvent

WSACreateEvent 関数は、新しいイベントオブジェクトを作成する。

WSACreateEvent

(プラグイン / モジュール : ws2_32.dll)

解説

WSACreateEvent 関数は、新しいイベントオブジェクトを作成する。

[戻り値]
エラーがない場合、WSACreateEvent はイベントオブジェクトのハンドルを返す。そうでない場合の戻り値は
WSA_INVALID_EVENT である。拡張エラー情報を取得するには、WSAGetLastError を呼び出す。
（以下省略）

[備考]
WSACreateEvent
関数は、初期状態が非シグナル状態の手動リセットイベントオブジェクトを作成する。返されるイベントオブジェクトのハンドルは子プロセスから継承できない。イベントオブジェクトには名前がない。WSASetEvent
関数を呼び出すとイベントオブジェクトの状態をシグナル状態に設定できる。WSAResetEvent
関数を呼び出すとイベントオブジェクトの状態を非シグナル状態に設定できる。イベントオブジェクトが不要になったら、WSACloseEvent
関数を呼び出して関連するリソースを解放すべきである。Windows Sockets 2 のイベントオブジェクトは Windows
環境ではシステムオブジェクトである。したがって、Windows
アプリケーションで手動リセットではなく自動リセットイベントを使いたい場合は、アプリケーションから直接 CreateEvent
関数を呼び出せばよい。イベントオブジェクトのスコープは生成したプロセス内に限られる。Windows Phone 8: この関数は
Windows Phone 8 以降の Windows Phone ストアアプリでサポートされる。Windows 8.1 および
Windows Server 2012 R2: この関数は、Windows 8.1、Windows Server 2012 R2 以降の
Windows ストアアプリでサポートされる。

情報