WSACreateEvent
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