Función WSACreateEvent (winsock2.h)

Artículo
03/08/2023

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
WSANOTINITIALISED	Debe producirse una llamada de WSAStartup correcta antes de usar esta función.
WSAENETDOWN	Error en el subsistema de red.
WSAEINPROGRESS	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.
WSA_NOT_ENOUGH_MEMORY	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