Waits until either the specified object is in the signaled state, or until the time-out interval elapses.

DWORD WaitForSingleObject(
    HANDLE hHandle,
    DWORD dwMilliseconds
);

DWORD RtWaitForSingleObject(
    HANDLE hHandle,
    DWORD dwMilliseconds
);

Parameters

hHandle

Handle to the object. For a list of object types whose handles can be specified, see the Remarks section.

dwMilliseconds

Specifies the time-out interval, in milliseconds. If the interval elapses, the function returns, even if the object's state is nonsignaled. If dwMilliseconds is zero, the function tests the object's state and returns immediately. If dwMilliseconds is INFINITE, the function's time-out interval never elapses.

Remarks

These functions cannot be called from a pure INtime thread.

The handle can refer to an object of the following type:

• Event: Wait until the event is signalled.
• Mutex: Wait until the mutex is not owned or recursively own the same mutex. When the mutex is owned and the current thread has a better priority than the owning thread, the priority of the owning thread is temporarily made equal to that of the current thread, until the owning thread releases the last mutex it owns.
• Semaphore: Wait until a unit is available.
• Process: Wait until the process terminates.
• Thread: Wait until the thread terminates.

You can also use RtWaitForSingleObject from a Windows application to wait for an iwin32 object. In that environment, when a mutex causes a change in a thread's priority, the thread is part of the iwin32x proxy; it is not the Windows thread!