Export (0) Print
Expand All

ThreadPool.UnsafeRegisterWaitForSingleObject Method (WaitHandle, WaitOrTimerCallback, Object, Int32, Boolean)

Registers a delegate to wait for a WaitHandle, using a 32-bit signed integer for the time-out in milliseconds.

Namespace: System.Threading
Assembly: mscorlib (in mscorlib.dll)

public static RegisteredWaitHandle UnsafeRegisterWaitForSingleObject (
	WaitHandle waitObject,
	WaitOrTimerCallback callBack,
	Object state,
	int millisecondsTimeOutInterval,
	bool executeOnlyOnce
)
public static RegisteredWaitHandle UnsafeRegisterWaitForSingleObject (
	WaitHandle waitObject, 
	WaitOrTimerCallback callBack, 
	Object state, 
	int millisecondsTimeOutInterval, 
	boolean executeOnlyOnce
)
public static function UnsafeRegisterWaitForSingleObject (
	waitObject : WaitHandle, 
	callBack : WaitOrTimerCallback, 
	state : Object, 
	millisecondsTimeOutInterval : int, 
	executeOnlyOnce : boolean
) : RegisteredWaitHandle

Parameters

waitObject

The WaitHandle to register.

callBack

The delegate to call when the waitObject parameter is signaled.

state

The object that is passed to the delegate.

millisecondsTimeOutInterval

The time-out in milliseconds. If the millisecondsTimeOutInterval parameter is zero (0), the function tests the object's state and returns immediately. If millisecondsTimeOutInterval is -1, the function's time-out interval never elapses.

executeOnlyOnce

true to indicate the thread will no longer wait on the waitObject parameter after the delegate has been called; false to indicate the timer is reset every time the wait operation completes until the wait is unregistered.

Return Value

The RegisteredWaitHandle object that can be used to cancel the registered wait operation.

Exception typeCondition

ArgumentOutOfRangeException

The millisecondsTimeOutInterval parameter is less than -1.

SecurityException

The caller does not have the required permission.

This version of RegisterWaitForSingleObject does not propagate the calling stack onto the worker thread. This allows code to lose the calling stack and thereby elevate its security privileges.

Caution noteCaution

Using UnsafeRegisterWaitForSingleObject could inadvertently open up a security hole. Code access security bases its permission checks on the permissions of all the callers on the stack. When work is queued on a thread pool thread using UnsafeRegisterWaitForSingleObject, the stack of the thread pool thread will not have the context of the actual callers. Malicious code might be able exploit this to avoid permission checks.

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see System Requirements.

.NET Framework

Supported in: 2.0, 1.1, 1.0

Community Additions

ADD
Show:
© 2014 Microsoft