Compartir a través de


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
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

Consulte también

CreateEvent

WSACloseEvent

WSAEnumNetworkEvents

WSAEventSelect

WSAGetOverlappedResult

WSARecv

WSARecvFrom

WSAResetEvent

WSASend

WSASendTo

WSASetEvent

WSAWaitForMultipleEvents

Funciones winsock

Referencia de Winsock