WaitHandle.WaitAny Method (WaitHandle(), Int32)
[ This article is for Windows Phone 8 developers. If you’re developing for Windows 10, see the latest documentation. ]
Waits for any of the elements in the specified array to receive a signal, using a 32-bit signed integer to specify the time interval.
Assembly: mscorlib (in mscorlib.dll)
'Declaration Public Shared Function WaitAny ( _ waitHandles As WaitHandle(), _ millisecondsTimeout As Integer _ ) As Integer
An array that contains the objects for which the current instance will wait.
The waitHandles parameter is Nothing.
One or more of the objects in the waitHandles array is Nothing.
The number of objects in waitHandles is greater than the system permits.
millisecondsTimeout is a negative number other than -1, which represents an infinite time-out.
waitHandles is an array with no elements.
If millisecondsTimeout is zero, the method does not block. It tests the state of the wait handles and returns immediately.
This method returns when the wait terminates, either when any of the handles are signaled or when a time-out occurs. If more than one object becomes signaled during the call, the return value is the array index of the signaled object with the smallest index value of all the signaled objects. On some implementations, if more that 64 handles are passed, a NotSupportedException is thrown.
The following example shows how to use this overload of the WaitAny method to report progress while waiting for multiple threads to finish. Each time the WaitAny method times out, the thread that was waiting reports progress to the user interface thread.
This code is part of a larger example provided for the WaitHandle class.
' Wait for ANY subtask to complete, and show progress. ' Create an array of ManualResetEvent wait handles. Each subtask will ' signal its ManualResetEvent when it is finished. Dim waitHandles() As WaitHandle = finished.ToArray() Dim index As Integer = WaitHandle.WaitTimeout While index = WaitHandle.WaitTimeout ' Wait for any WaitHandle to be signaled. Use a timeout of 250 milliseconds ' to send progress reports. If a timeout occurs, WaitTimeout is returned; ' if a WaitHandle signals, the array index of the WaitHandle is returned. ' index = WaitHandle.WaitAny(waitHandles, 250) worker.ReportProgress(1) End While