WSAResetEvent 関数 (winsock2.h)

WSAResetEvent 関数は、指定したイベント オブジェクトの状態を非署名にリセットします。

構文

BOOL WSAAPI WSAResetEvent(
  [in] WSAEVENT hEvent
);

パラメーター

[in] hEvent

開いているイベント オブジェクト ハンドルを識別するハンドル。

戻り値

WSAResetEvent 関数が成功した場合、戻り値は TRUE になります。 関数が失敗した場合、戻り値は FALSE になります。 拡張エラー情報を取得するには、 WSAGetLastError を呼び出します。

エラー コード	意味
WSANOTINITIALIZED	この関数を使用する前に 、WSAStartup 呼び出しが正常に行われる必要があります。
WSAENETDOWN	ネットワーク サブシステムが失敗しました。
WSAEINPROGRESS	ブロックしている Windows ソケット 1.1 呼び出しが進行中であるか、サービス プロバイダーがコールバック関数を処理しています。
WSA_INVALID_HANDLE	hEvent パラメーターが有効なイベント オブジェクト ハンドルではありません。

解説

WSAResetEvent 関数は、イベント オブジェクトの状態を非署名に設定するために使用されます。

WSAEventSelect 関数で使用されるイベント オブジェクトの状態をリセットする適切な方法は、イベント オブジェクトのハンドルを hEventObject パラメーターの WSAEnumNetworkEvents 関数に渡すことです。 これにより、イベント オブジェクトがリセットされ、ソケット上のアクティブな FD イベントの状態がアトミックに調整されます。

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

Windows 8.1と Windows 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

関連項目

WSACloseEvent

WSACreateEvent

WSAEnumNetworkEvents

WSAEventSelect

WSASetEvent

Winsock 関数

Winsock リファレンス