语言

ThreadPool.UnsafeRegisterWaitForSingleObject 方法

定义

注册一个委托以等待 a WaitHandle,但不将调用堆栈传播到工作线程。

重载

名称 说明
UnsafeRegisterWaitForSingleObject(WaitHandle, WaitOrTimerCallback, Object, TimeSpan, Boolean)

注册一个委托以等待 a WaitHandle,并 TimeSpan 指定超时值。此方法不会将调用堆栈传播到工作线程。

UnsafeRegisterWaitForSingleObject(WaitHandle, WaitOrTimerCallback, Object, Int32, Boolean)

使用 32 位带符号整数为 WaitHandle超时(以毫秒为单位)注册要等待的委托。 此方法不会将调用堆栈传播到工作线程。

UnsafeRegisterWaitForSingleObject(WaitHandle, WaitOrTimerCallback, Object, Int64, Boolean)

注册一个委托以等待 a WaitHandle,为超时指定 64 位有符号整数(以毫秒为单位)。 此方法不会将调用堆栈传播到工作线程。

UnsafeRegisterWaitForSingleObject(WaitHandle, WaitOrTimerCallback, Object, UInt32, Boolean)

注册一个委托以等待 a WaitHandle,为超时指定 32 位无符号整数(以毫秒为单位)。 此方法不会将调用堆栈传播到工作线程。

UnsafeRegisterWaitForSingleObject(WaitHandle, WaitOrTimerCallback, Object, TimeSpan, Boolean)

Source:
ThreadPoolWorkQueue.cs
Source:
ThreadPoolWorkQueue.cs
Source:
ThreadPoolWorkQueue.cs
Source:
ThreadPoolWorkQueue.cs
Source:
ThreadPoolWorkQueue.cs

注册一个委托以等待 a WaitHandle,并 TimeSpan 指定超时值。此方法不会将调用堆栈传播到工作线程。

public:
 static System::Threading::RegisteredWaitHandle ^ UnsafeRegisterWaitForSingleObject(System::Threading::WaitHandle ^ waitObject, System::Threading::WaitOrTimerCallback ^ callBack, System::Object ^ state, TimeSpan timeout, bool executeOnlyOnce);
[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public static System.Threading.RegisteredWaitHandle UnsafeRegisterWaitForSingleObject(System.Threading.WaitHandle waitObject, System.Threading.WaitOrTimerCallback callBack, object? state, TimeSpan timeout, bool executeOnlyOnce);
public static System.Threading.RegisteredWaitHandle UnsafeRegisterWaitForSingleObject(System.Threading.WaitHandle waitObject, System.Threading.WaitOrTimerCallback callBack, object state, TimeSpan timeout, bool executeOnlyOnce);
public static System.Threading.RegisteredWaitHandle UnsafeRegisterWaitForSingleObject(System.Threading.WaitHandle waitObject, System.Threading.WaitOrTimerCallback callBack, object? state, TimeSpan timeout, bool executeOnlyOnce);
[System.Security.SecurityCritical]
public static System.Threading.RegisteredWaitHandle UnsafeRegisterWaitForSingleObject(System.Threading.WaitHandle waitObject, System.Threading.WaitOrTimerCallback callBack, object state, TimeSpan timeout, bool executeOnlyOnce);
[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
static member UnsafeRegisterWaitForSingleObject : System.Threading.WaitHandle * System.Threading.WaitOrTimerCallback * obj * TimeSpan * bool -> System.Threading.RegisteredWaitHandle
static member UnsafeRegisterWaitForSingleObject : System.Threading.WaitHandle * System.Threading.WaitOrTimerCallback * obj * TimeSpan * bool -> System.Threading.RegisteredWaitHandle
[<System.Security.SecurityCritical>]
static member UnsafeRegisterWaitForSingleObject : System.Threading.WaitHandle * System.Threading.WaitOrTimerCallback * obj * TimeSpan * bool -> System.Threading.RegisteredWaitHandle
Public Shared Function UnsafeRegisterWaitForSingleObject (waitObject As WaitHandle, callBack As WaitOrTimerCallback, state As Object, timeout As TimeSpan, executeOnlyOnce As Boolean) As RegisteredWaitHandle

参数

waitObject
WaitHandle

要 WaitHandle 注册的。 使用其他项WaitHandle。Mutex

callBack
WaitOrTimerCallback

发出参数信号时要调用的 waitObject 委托。

state
Object

传递给委托的对象。

timeout
TimeSpan

由 a TimeSpan. 表示的超时值。 如果 timeout 为 0(零),则函数将测试对象的状态并立即返回。 如果 timeout 为 -1,则函数的超时间隔永远不会过。

executeOnlyOnce
Boolean

true 如果指示线程在调用委托后不再等待 waitObject 参数, false 则指示每次等待操作完成时都会重置计时器,直到取消注册等待。

返回

RegisteredWaitHandle可用于取消已注册的等待操作的对象。

特性

例外

参数 timeout 小于 -1。

参数 timeout 大于 Int32.MaxValue。

调用方没有所需的权限。

注解

RegisterWaitForSingleObject与该方法不同,UnsafeRegisterWaitForSingleObject不会将调用堆栈传播到工作线程。 这允许代码丢失调用堆栈,从而提升其安全特权。

Caution

使用 UnsafeRegisterWaitForSingleObject 可能会无意中打开安全漏洞。 代码访问安全基于其权限检查堆栈上所有调用方的权限。 使用 UnsafeRegisterWaitForSingleObject线程池线程上的工作排队时,线程池线程的堆栈将不具有实际调用方的上下文。 恶意代码可能会利用此漏洞来避免权限检查。

对 Mutex 使用 waitObject 不会为回调提供相互排斥,因为基础Windows API 使用默认的 WT_EXECUTEDEFAULT 标志,因此每个回调在单独的线程池线程上调度。

使用 RegisteredWaitHandle 此方法返回的函数完成后,调用该方法 RegisteredWaitHandle.Unregister 以释放对等待句柄的引用。 建议始终调用 RegisteredWaitHandle.Unregister 该方法,即使指定 true 了 executeOnlyOnce此方法。 如果调用 RegisteredWaitHandle.Unregister 方法,而不是依赖于已注册的等待句柄的终结器,垃圾回收更高效。

另请参阅

适用于

UnsafeRegisterWaitForSingleObject(WaitHandle, WaitOrTimerCallback, Object, Int32, Boolean)

Source:
ThreadPoolWorkQueue.cs
Source:
ThreadPoolWorkQueue.cs
Source:
ThreadPoolWorkQueue.cs
Source:
ThreadPoolWorkQueue.cs
Source:
ThreadPoolWorkQueue.cs

使用 32 位带符号整数为 WaitHandle超时(以毫秒为单位)注册要等待的委托。 此方法不会将调用堆栈传播到工作线程。

public:
 static System::Threading::RegisteredWaitHandle ^ UnsafeRegisterWaitForSingleObject(System::Threading::WaitHandle ^ waitObject, System::Threading::WaitOrTimerCallback ^ callBack, System::Object ^ state, int millisecondsTimeOutInterval, bool executeOnlyOnce);
[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public static System.Threading.RegisteredWaitHandle UnsafeRegisterWaitForSingleObject(System.Threading.WaitHandle waitObject, System.Threading.WaitOrTimerCallback callBack, object? state, int millisecondsTimeOutInterval, bool executeOnlyOnce);
public static System.Threading.RegisteredWaitHandle UnsafeRegisterWaitForSingleObject(System.Threading.WaitHandle waitObject, System.Threading.WaitOrTimerCallback callBack, object state, int millisecondsTimeOutInterval, bool executeOnlyOnce);
public static System.Threading.RegisteredWaitHandle UnsafeRegisterWaitForSingleObject(System.Threading.WaitHandle waitObject, System.Threading.WaitOrTimerCallback callBack, object? state, int millisecondsTimeOutInterval, bool executeOnlyOnce);
[System.Security.SecurityCritical]
public static System.Threading.RegisteredWaitHandle UnsafeRegisterWaitForSingleObject(System.Threading.WaitHandle waitObject, System.Threading.WaitOrTimerCallback callBack, object state, int millisecondsTimeOutInterval, bool executeOnlyOnce);
[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
static member UnsafeRegisterWaitForSingleObject : System.Threading.WaitHandle * System.Threading.WaitOrTimerCallback * obj * int * bool -> System.Threading.RegisteredWaitHandle
static member UnsafeRegisterWaitForSingleObject : System.Threading.WaitHandle * System.Threading.WaitOrTimerCallback * obj * int * bool -> System.Threading.RegisteredWaitHandle
[<System.Security.SecurityCritical>]
static member UnsafeRegisterWaitForSingleObject : System.Threading.WaitHandle * System.Threading.WaitOrTimerCallback * obj * int * bool -> System.Threading.RegisteredWaitHandle
Public Shared Function UnsafeRegisterWaitForSingleObject (waitObject As WaitHandle, callBack As WaitOrTimerCallback, state As Object, millisecondsTimeOutInterval As Integer, executeOnlyOnce As Boolean) As RegisteredWaitHandle

参数

waitObject
WaitHandle

要 WaitHandle 注册的。 使用其他项WaitHandle。Mutex

callBack
WaitOrTimerCallback

发出参数信号时要调用的 waitObject 委托。

state
Object

传递给委托的对象。

millisecondsTimeOutInterval
Int32

超时(以毫秒为单位)。 millisecondsTimeOutInterval如果参数为 0(零),则函数将测试对象的状态并立即返回。 如果 millisecondsTimeOutInterval 为 -1,则函数的超时间隔永远不会过。

executeOnlyOnce
Boolean

true 如果指示线程在调用委托后不再等待 waitObject 参数, false 则指示每次等待操作完成时都会重置计时器,直到取消注册等待。

返回

RegisteredWaitHandle可用于取消已注册的等待操作的对象。

特性

例外

参数 millisecondsTimeOutInterval 小于 -1。

调用方没有所需的权限。

注解

RegisterWaitForSingleObject与该方法不同,UnsafeRegisterWaitForSingleObject不会将调用堆栈传播到工作线程。 这允许代码丢失调用堆栈,从而提升其安全特权。

Caution

使用 UnsafeRegisterWaitForSingleObject 可能会无意中打开安全漏洞。 代码访问安全基于其权限检查堆栈上所有调用方的权限。 使用 UnsafeRegisterWaitForSingleObject线程池线程上的工作排队时,线程池线程的堆栈将不具有实际调用方的上下文。 恶意代码可能会利用此漏洞来避免权限检查。

对 Mutex 使用 waitObject 不会为回调提供相互排斥,因为基础Windows API 使用默认的 WT_EXECUTEDEFAULT 标志,因此每个回调在单独的线程池线程上调度。

使用 RegisteredWaitHandle 此方法返回的函数完成后,调用该方法 RegisteredWaitHandle.Unregister 以释放对等待句柄的引用。 建议始终调用 RegisteredWaitHandle.Unregister 该方法,即使指定 true 了 executeOnlyOnce此方法。 如果调用 RegisteredWaitHandle.Unregister 方法,而不是依赖于已注册的等待句柄的终结器,垃圾回收更高效。

另请参阅

适用于

UnsafeRegisterWaitForSingleObject(WaitHandle, WaitOrTimerCallback, Object, Int64, Boolean)

Source:
ThreadPoolWorkQueue.cs
Source:
ThreadPoolWorkQueue.cs
Source:
ThreadPoolWorkQueue.cs
Source:
ThreadPoolWorkQueue.cs
Source:
ThreadPoolWorkQueue.cs

注册一个委托以等待 a WaitHandle,为超时指定 64 位有符号整数(以毫秒为单位)。 此方法不会将调用堆栈传播到工作线程。

public:
 static System::Threading::RegisteredWaitHandle ^ UnsafeRegisterWaitForSingleObject(System::Threading::WaitHandle ^ waitObject, System::Threading::WaitOrTimerCallback ^ callBack, System::Object ^ state, long millisecondsTimeOutInterval, bool executeOnlyOnce);
[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public static System.Threading.RegisteredWaitHandle UnsafeRegisterWaitForSingleObject(System.Threading.WaitHandle waitObject, System.Threading.WaitOrTimerCallback callBack, object? state, long millisecondsTimeOutInterval, bool executeOnlyOnce);
public static System.Threading.RegisteredWaitHandle UnsafeRegisterWaitForSingleObject(System.Threading.WaitHandle waitObject, System.Threading.WaitOrTimerCallback callBack, object state, long millisecondsTimeOutInterval, bool executeOnlyOnce);
public static System.Threading.RegisteredWaitHandle UnsafeRegisterWaitForSingleObject(System.Threading.WaitHandle waitObject, System.Threading.WaitOrTimerCallback callBack, object? state, long millisecondsTimeOutInterval, bool executeOnlyOnce);
[System.Security.SecurityCritical]
public static System.Threading.RegisteredWaitHandle UnsafeRegisterWaitForSingleObject(System.Threading.WaitHandle waitObject, System.Threading.WaitOrTimerCallback callBack, object state, long millisecondsTimeOutInterval, bool executeOnlyOnce);
[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
static member UnsafeRegisterWaitForSingleObject : System.Threading.WaitHandle * System.Threading.WaitOrTimerCallback * obj * int64 * bool -> System.Threading.RegisteredWaitHandle
static member UnsafeRegisterWaitForSingleObject : System.Threading.WaitHandle * System.Threading.WaitOrTimerCallback * obj * int64 * bool -> System.Threading.RegisteredWaitHandle
[<System.Security.SecurityCritical>]
static member UnsafeRegisterWaitForSingleObject : System.Threading.WaitHandle * System.Threading.WaitOrTimerCallback * obj * int64 * bool -> System.Threading.RegisteredWaitHandle
Public Shared Function UnsafeRegisterWaitForSingleObject (waitObject As WaitHandle, callBack As WaitOrTimerCallback, state As Object, millisecondsTimeOutInterval As Long, executeOnlyOnce As Boolean) As RegisteredWaitHandle

参数

waitObject
WaitHandle

要 WaitHandle 注册的。 使用其他项WaitHandle。Mutex

callBack
WaitOrTimerCallback

发出参数信号时要调用的 waitObject 委托。

state
Object

传递给委托的对象。

millisecondsTimeOutInterval
Int64

超时(以毫秒为单位)。 millisecondsTimeOutInterval如果参数为 0(零),则函数将测试对象的状态并立即返回。 如果 millisecondsTimeOutInterval 为 -1,则函数的超时间隔永远不会过。

executeOnlyOnce
Boolean

true 如果指示线程在调用委托后不再等待 waitObject 参数, false 则指示每次等待操作完成时都会重置计时器,直到取消注册等待。

返回

RegisteredWaitHandle可用于取消已注册的等待操作的对象。

特性

例外

参数 millisecondsTimeOutInterval 小于 -1。

调用方没有所需的权限。

注解

RegisterWaitForSingleObject与该方法不同,UnsafeRegisterWaitForSingleObject不会将调用堆栈传播到工作线程。 这允许代码丢失调用堆栈,从而提升其安全特权。

Caution

使用 UnsafeRegisterWaitForSingleObject 可能会无意中打开安全漏洞。 代码访问安全基于其权限检查堆栈上所有调用方的权限。 使用 UnsafeRegisterWaitForSingleObject线程池线程上的工作排队时,线程池线程的堆栈将不具有实际调用方的上下文。 恶意代码可能会利用此漏洞来避免权限检查。

对 Mutex 使用 waitObject 不会为回调提供相互排斥,因为基础Windows API 使用默认的 WT_EXECUTEDEFAULT 标志,因此每个回调在单独的线程池线程上调度。

使用 RegisteredWaitHandle 此方法返回的函数完成后,调用该方法 RegisteredWaitHandle.Unregister 以释放对等待句柄的引用。 建议始终调用 RegisteredWaitHandle.Unregister 该方法,即使指定 true 了 executeOnlyOnce此方法。 如果调用 RegisteredWaitHandle.Unregister 方法,而不是依赖于已注册的等待句柄的终结器,垃圾回收更高效。

另请参阅

适用于

UnsafeRegisterWaitForSingleObject(WaitHandle, WaitOrTimerCallback, Object, UInt32, Boolean)

Source:
ThreadPoolWorkQueue.cs
Source:
ThreadPoolWorkQueue.cs
Source:
ThreadPoolWorkQueue.cs
Source:
ThreadPoolWorkQueue.cs
Source:
ThreadPoolWorkQueue.cs

重要

此 API 不符合 CLS。

注册一个委托以等待 a WaitHandle,为超时指定 32 位无符号整数(以毫秒为单位)。 此方法不会将调用堆栈传播到工作线程。

public:
 static System::Threading::RegisteredWaitHandle ^ UnsafeRegisterWaitForSingleObject(System::Threading::WaitHandle ^ waitObject, System::Threading::WaitOrTimerCallback ^ callBack, System::Object ^ state, System::UInt32 millisecondsTimeOutInterval, bool executeOnlyOnce);
[System.CLSCompliant(false)]
[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public static System.Threading.RegisteredWaitHandle UnsafeRegisterWaitForSingleObject(System.Threading.WaitHandle waitObject, System.Threading.WaitOrTimerCallback callBack, object? state, uint millisecondsTimeOutInterval, bool executeOnlyOnce);
[System.CLSCompliant(false)]
public static System.Threading.RegisteredWaitHandle UnsafeRegisterWaitForSingleObject(System.Threading.WaitHandle waitObject, System.Threading.WaitOrTimerCallback callBack, object state, uint millisecondsTimeOutInterval, bool executeOnlyOnce);
[System.CLSCompliant(false)]
public static System.Threading.RegisteredWaitHandle UnsafeRegisterWaitForSingleObject(System.Threading.WaitHandle waitObject, System.Threading.WaitOrTimerCallback callBack, object? state, uint millisecondsTimeOutInterval, bool executeOnlyOnce);
[System.CLSCompliant(false)]
[System.Security.SecurityCritical]
public static System.Threading.RegisteredWaitHandle UnsafeRegisterWaitForSingleObject(System.Threading.WaitHandle waitObject, System.Threading.WaitOrTimerCallback callBack, object state, uint millisecondsTimeOutInterval, bool executeOnlyOnce);
[<System.CLSCompliant(false)>]
[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
static member UnsafeRegisterWaitForSingleObject : System.Threading.WaitHandle * System.Threading.WaitOrTimerCallback * obj * uint32 * bool -> System.Threading.RegisteredWaitHandle
[<System.CLSCompliant(false)>]
static member UnsafeRegisterWaitForSingleObject : System.Threading.WaitHandle * System.Threading.WaitOrTimerCallback * obj * uint32 * bool -> System.Threading.RegisteredWaitHandle
[<System.CLSCompliant(false)>]
[<System.Security.SecurityCritical>]
static member UnsafeRegisterWaitForSingleObject : System.Threading.WaitHandle * System.Threading.WaitOrTimerCallback * obj * uint32 * bool -> System.Threading.RegisteredWaitHandle
Public Shared Function UnsafeRegisterWaitForSingleObject (waitObject As WaitHandle, callBack As WaitOrTimerCallback, state As Object, millisecondsTimeOutInterval As UInteger, executeOnlyOnce As Boolean) As RegisteredWaitHandle

参数

waitObject
WaitHandle

要 WaitHandle 注册的。 使用其他项WaitHandle。Mutex

callBack
WaitOrTimerCallback

发出参数信号时要调用的 waitObject 委托。

state
Object

传递给委托的对象。

millisecondsTimeOutInterval
UInt32

超时(以毫秒为单位)。 millisecondsTimeOutInterval如果参数为 0(零),则函数将测试对象的状态并立即返回。 如果 millisecondsTimeOutInterval 为 -1,则函数的超时间隔永远不会过。

executeOnlyOnce
Boolean

true 如果指示线程在调用委托后不再等待 waitObject 参数, false 则指示每次等待操作完成时都会重置计时器,直到取消注册等待。

返回

RegisteredWaitHandle可用于取消已注册的等待操作的对象。

特性

例外

调用方没有所需的权限。

注解

RegisterWaitForSingleObject与该方法不同,UnsafeRegisterWaitForSingleObject不会将调用堆栈传播到工作线程。 这允许代码丢失调用堆栈,从而提升其安全特权。

Caution

使用 UnsafeRegisterWaitForSingleObject 可能会无意中打开安全漏洞。 代码访问安全基于其权限检查堆栈上所有调用方的权限。 使用 UnsafeRegisterWaitForSingleObject线程池线程上的工作排队时,线程池线程的堆栈将不具有实际调用方的上下文。 恶意代码可能会利用此漏洞来避免权限检查。

对 Mutex 使用 waitObject 不会为回调提供相互排斥,因为基础Windows API 使用默认的 WT_EXECUTEDEFAULT 标志,因此每个回调在单独的线程池线程上调度。

使用 RegisteredWaitHandle 此方法返回的函数完成后,调用该方法 RegisteredWaitHandle.Unregister 以释放对等待句柄的引用。 建议始终调用 RegisteredWaitHandle.Unregister 该方法,即使指定 true 了 executeOnlyOnce此方法。 如果调用 RegisteredWaitHandle.Unregister 方法,而不是依赖于已注册的等待句柄的终结器,垃圾回收更高效。

另请参阅

适用于