WSACreateEvent 函数 (winsock2.h)

WSACreateEvent 函数创建新的事件对象。

语法

WSAEVENT WSAAPI WSACreateEvent();

如果未发生错误， WSACreateEvent 将返回事件对象的句柄。否则，返回值WSA_INVALID_EVENT。若要获取扩展的错误信息，请调用 WSAGetLastError。

错误代码	含义
WSANOTINITIALISED	在使用此函数之前，必须成功调用 WSAStartup 。
WSAENETDOWN	网络子系统失败。
WSAEINPROGRESS	阻止 Windows Sockets 1.1 调用正在进行，或者服务提供程序仍在处理回调函数。
WSA_NOT_ENOUGH_MEMORY	可用内存不足，无法创建事件对象。

WSACreateEvent 函数创建初始状态为“未签名”的手动重置事件对象。子进程不能继承返回的事件对象的句柄。事件对象未命名。

可以调用 WSASetEvent 函数，将事件对象的状态设置为已发出信号。可以调用 WSAResetEvent 函数，将事件对象的状态设置为非签名。不再需要事件对象时，应调用 WSACloseEvent 函数以释放与事件对象关联的资源。

Windows 套接字 2 事件对象是 Windows 环境中的系统对象。因此，如果 Windows 应用程序想要使用自动重置事件而不是手动重置事件，则应用程序可以直接调用 CreateEvent 函数。事件对象的作用域仅限于在其中创建它的进程。

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