What could cause the ResetEvent API to fail?

I'm writing a VC++ application. Just for the sake of argument, what could cause the ResetEvent API to 开发者_如何学Pythonfail? The Microsoft documentation is not clear on this. Thanks.

Most commonly an invalid handle will cause this to fail. An invalid handle, in turn, could result from:

1. the handle being closed by another process or thread prematurely
2. passing gobbledy-gook to ResetEvent()
3. Passing a handle to a thing that isn't an even

Number 1 can often be avoided by creating a duplicate of the handle, by calling DuplicateHandle().

GetLastError() generally will tell you exactly what the problem is, or at least point you in the direction.

Without access to the source of Windows we can only guess. Here's my guess at what could go wrong:

• The handle is not a valid handle to an event object.
• The handle does not have the necessary access rights. The documentation states that the handle must have the EVENT_MODIFY_STATE access right.
• The OS runs out of memory or has some other critical failure.

Reading the WINE source reveals no other explicit failure modes.