WSACreateEvent  1XMCRC6 

The Windows Sockets connect function creates a new event object.

WSAEVENT  WSACreateEvent(void);

Remarks

The event object created by this function is manual reset, with an initial state of nonsignaled. Windows Sockets 2 event objects are system objects in Win32 environments. Therefore, if a Win32 application desires auto reset events, it may call the native CreateEvent Win32 function directly. The scope of an event object is limited to the process in which it is created.

Return Values

If the function succeeds, the return value is the handle of the event object.

If the function fails, the return value is WSA_INVALID_EVENT. To get extended error information, call WSAGetLastError.

Error Codes

WSANOTINITIALISED

A successful WSAStartup must occur before using this function.

WSAENETDOWN

The network subsystem has failed.

WSAEINPROGRESS

A blocking Windows Sockets 1.1 call is in progress, or the service provider is still processing a callback function.

WSA_NOT_ENOUGH_MEMORY

Not enough free memory available to create the event object.

 

See Also

WSACloseEvent, WSAEnumNetworkEvents, WSAEventSelect, WSAGetOverlappedResult, WSARecv, WSARecvFrom, WSAResetEvent, WSASend, WSASendTo, WSASetEvent, WSAWaitForMultipleEvents