WSACloseEvent 函式 (winsock2.h)
WSACloseEvent 函式會關閉開啟的事件物件句柄。
語法
BOOL WSAAPI WSACloseEvent(
[in] WSAEVENT hEvent
);
參數
[in] hEvent
識別開啟事件的物件句柄。
傳回值
如果函式成功，則傳回值為 TRUE。
如果函式失敗，則傳回值為 FALSE。 若要取得擴充錯誤資訊，請呼叫 WSAGetLastError。
| 錯誤碼 | 意義 |
|---|---|
| 使用此函式之前，必須先進行成功的 WSAStartup 呼叫。 | |
| 網路子系統失敗。 | |
| 封鎖的 Windows Sockets 1.1 呼叫正在進行中，或者服務提供者仍在處理回呼函式。 | |
| hEvent 不是有效的事件物件句柄。 |
備註
WSACloseEvent 函式會關閉事件物件的句柄，並釋放與事件對象相關聯的資源。 此函式用來關閉 WSACreateEvent 函式所建立的句柄。 關閉事件物件的句柄之後，此句柄的進一步參考將會失敗，並出現錯誤 WSA_INVALID_HANDLE。
Windows Phone 8：Windows Phone 8 和更新版本上的 Windows Phone Store 應用程式支援此函式。
Windows 8.1 和 Windows Server 2012 R2：Windows 市集應用程式支援此函式，Windows 8.1、Windows Server 2012 R2 及更新版本。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows 8.1、Windows Vista [傳統型應用程式 |UWP 應用程式] |
| 最低支援的伺服器 | Windows Server 2003 [傳統型應用程式 |UWP 應用程式] |
| 目標平台 | Windows |
| 標頭 | winsock2.h |
| 程式庫 | Ws2_32.lib |
| Dll | Ws2_32.dll |