Función WSACreateEvent (winsock2.h)
La función WSACreateEvent crea un nuevo objeto de evento.
Sintaxis
WSAEVENT WSAAPI WSACreateEvent();
Valor devuelto
Si no se produce ningún error, WSACreateEvent devuelve el identificador del objeto de evento. De lo contrario, el valor devuelto es WSA_INVALID_EVENT. Para obtener información de error extendida, llame a WSAGetLastError.
| Código de error | Significado |
|---|---|
| Debe producirse una llamada de WSAStartup correcta antes de usar esta función. | |
| Error en el subsistema de red. | |
| Una llamada de Bloqueo de Windows Sockets 1.1 está en curso o el proveedor de servicios sigue procesando una función de devolución de llamada. | |
| No hay suficiente memoria disponible para crear el objeto de evento. |
Comentarios
La función WSACreateEvent crea un objeto de evento de restablecimiento manual con un estado inicial sin signo. Los procesos secundarios no pueden heredar el identificador del objeto de evento devuelto. El objeto de evento no tiene nombre.
Se puede llamar a la función WSASetEvent para establecer el estado del objeto de evento en señalizado. Se puede llamar a la función WSAResetEvent para establecer el estado del objeto de evento en sin signo. Cuando ya no se necesita un objeto de evento, se debe llamar a la función WSACloseEvent para liberar los recursos asociados al objeto de evento.
Los objetos de eventos de Windows Sockets 2 son objetos del sistema en entornos de Windows. Por lo tanto, si una aplicación de Windows quiere usar un evento de restablecimiento automático en lugar de un evento de restablecimiento manual, la aplicación puede llamar directamente a la función CreateEvent . El ámbito de un objeto de evento se limita al proceso en el que se crea.
Windows Phone 8: esta función es compatible con las aplicaciones de Windows Phone Store en Windows Phone 8 y versiones posteriores.
Windows 8.1 y Windows Server 2012 R2: esta función es compatible con las aplicaciones de la Tienda Windows en Windows 8.1, Windows Server 2012 R2 y versiones posteriores.
Requisitos
| Cliente mínimo compatible | Windows 8.1, Windows Vista [aplicaciones de escritorio | Aplicaciones para UWP] |
| Servidor mínimo compatible | Windows Server 2003 [aplicaciones de escritorio | aplicaciones para UWP] |
| Plataforma de destino | Windows |
| Encabezado | winsock2.h |
| Library | Ws2_32.lib |
| Archivo DLL | Ws2_32.dll |