Platform SDK: Windows Sockets

WPUCreateEvent

The WPUCreateEvent function creates a new event object.

WSAEVENT WPUCreateEvent (
  LPINT   lpErrno  
);

Parameters

lpErrno
[out] Pointer to the error code.

Return Values

If no error occurs, WPUCreateEvent function returns the handle of the event object.

Otherwise, the return value is WSA_INVALID_EVENT and a specific error code is available in lpErrno.

Remarks

The event object created by this function is manual reset with an initial state of nonsignaled. If a Win32 service provider wants auto reset events, it can call the Win32 CreateEvent function directly. For more information, see CreateEvent.

Error Codes

Error code Meaning
WSA_NOT_ENOUGH_MEMORY Not enough free memory available to create the event object.

Requirements

  Version: Requires Windows Sockets 2.0.
  Header: Declared in Ws2spi.h.

See Also

WPUCloseEvent