WSACloseEvent 関数 (winsock2.h)

WSACloseEvent 関数は、開いているイベントオブジェクトハンドルを閉じます。

構文

BOOL WSAAPI WSACloseEvent(
  [in] WSAEVENT hEvent
);

パラメーター

[in] hEvent

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

戻り値

関数が成功した場合、戻り値は TRUE になります。

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

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

注釈

WSACloseEvent 関数は、イベントオブジェクトへのハンドルを閉じ、イベントオブジェクトに関連付けられているリソースを解放します。この関数は、 WSACreateEvent 関数によって作成されたハンドルを閉じるのに使用されます。イベントオブジェクトへのハンドルが閉じられると、このハンドルへのそれ以上の参照はエラー WSA_INVALID_HANDLEで失敗します。

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