WPUCreateEvent

The WPUCreateEvent function creates a new event object.

WSAEVENT WPUCreateEvent (
  LPINT lpErrno  
);
 

Parameters

lpErrno
[out] A pointer to the error code.

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.

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.

Error Codes

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

QuickInfo

  Windows NT: Yes
  Windows: Yes
  Windows CE: Unsupported.
  Header: Declared in ws2spi.h.

See Also

WPUCloseEvent