WSACreateEvent 函数 (winsock2.h)
WSACreateEvent 函数创建新的事件对象。
语法
WSAEVENT WSAAPI WSACreateEvent();
返回值
如果未发生错误， WSACreateEvent 将返回事件对象的句柄。 否则，返回值WSA_INVALID_EVENT。 若要获取扩展的错误信息，请调用 WSAGetLastError。
| 错误代码 | 含义 |
|---|---|
| 在使用此函数之前，必须成功调用 WSAStartup 。 | |
| 网络子系统失败。 | |
| 阻止 Windows Sockets 1.1 调用正在进行，或者服务提供程序仍在处理回调函数。 | |
| 可用内存不足，无法创建事件对象。 |
注解
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 |