次の方法で共有


WSACreateEvent 関数 (winsock2.h)

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

構文

WSAEVENT WSAAPI WSACreateEvent();

戻り値

エラーが発生しない場合、 WSACreateEvent はイベント オブジェクトのハンドルを返します。 それ以外の場合、戻り値はWSA_INVALID_EVENT。 拡張エラー情報を取得するには、 WSAGetLastError を呼び出します。

エラー コード 意味
WSANOTINITIALIZED
この関数を使用する前に、 WSAStartup 呼び出しが正常に行われる必要があります。
WSAENETDOWN
ネットワーク サブシステムが失敗しました。
WSAEINPROGRESS
ブロックしている Windows Sockets 1.1 呼び出しが進行中であるか、サービス プロバイダーがコールバック関数を処理しています。
WSA_NOT_ENOUGH_MEMORY
イベント オブジェクトを作成するのに十分な空きメモリがありません。

解説

WSACreateEvent 関数は、初期状態が非署名の手動リセット イベント オブジェクトを作成します。 返されるイベント オブジェクトのハンドルは、子プロセスによって継承できません。 イベント オブジェクトに名前が付けられていない。

WSASetEvent 関数を呼び出して、イベント オブジェクトの状態を signaled に設定できます。 WSAResetEvent 関数を呼び出して、イベント オブジェクトの状態を非署名に設定できます。 イベント オブジェクトが不要になったら、イベント オブジェクトに関連付けられているリソースを解放するために WSACloseEvent 関数を呼び出す必要があります。

Windows Sockets 2 イベント オブジェクトは、Windows 環境のシステム オブジェクトです。 したがって、Windows アプリケーションが手動リセット イベントではなく自動リセット イベントを使用する場合、アプリケーションは CreateEvent 関数を直接呼び出すことができます。 イベント オブジェクトのスコープは、作成されるプロセスに限定されます。

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

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

要件

   
サポートされている最小のクライアント Windows 8.1、Windows Vista [デスクトップ アプリ |UWP アプリ]
サポートされている最小のサーバー Windows Server 2003 [デスクトップ アプリのみ | UWP アプリ]
対象プラットフォーム Windows
ヘッダー winsock2.h
Library Ws2_32.lib
[DLL] Ws2_32.dll

関連項目

CreateEvent

WSACloseEvent

WSAEnumNetworkEvents

WSAEventSelect

WSAGetOverlappedResult

WSARecv

WSARecvFrom

WSAResetEvent

WSASend

WSASendTo

WSASetEvent

WSAWaitForMultipleEvents

Winsock 関数

Winsock リファレンス