WSAResetEvent 関数 (winsock2.h)
WSAResetEvent 関数は、指定したイベント オブジェクトの状態を非署名にリセットします。
構文
BOOL WSAAPI WSAResetEvent(
[in] WSAEVENT hEvent
);
パラメーター
[in] hEvent
開いているイベント オブジェクト ハンドルを識別するハンドル。
戻り値
WSAResetEvent 関数が成功した場合、戻り値は TRUE になります。 関数が失敗した場合、戻り値は FALSE になります。 拡張エラー情報を取得するには、 WSAGetLastError を呼び出します。
| エラー コード | 意味 |
|---|---|
| この関数を使用する前に 、WSAStartup 呼び出しが正常に行われる必要があります。 | |
| ネットワーク サブシステムが失敗しました。 | |
| ブロックしている Windows ソケット 1.1 呼び出しが進行中であるか、サービス プロバイダーがコールバック関数を処理しています。 | |
| 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 |