ThreadPool.UnsafeRegisterWaitForSingleObject Metoda

Definice

Obor názvů:

System.Threading

Sestavení:

System.Threading.ThreadPool.dll

Zaregistruje delegáta, aby čekal na WaitHandle, ale nešířit zásobník volání do pracovního vlákna.

Přetížení

UnsafeRegisterWaitForSingleObject(WaitHandle, WaitOrTimerCallback, Object, TimeSpan, Boolean)	Zaregistruje delegáta, který bude čekat na WaitHandlea zadá TimeSpan hodnotu časového limitu. Tato metoda nerozšíruje zásobník volání do pracovního vlákna.
UnsafeRegisterWaitForSingleObject(WaitHandle, WaitOrTimerCallback, Object, Int32, Boolean)	Zaregistruje delegáta pro čekání WaitHandlena , s použitím 32bitového celého čísla se znaménkem pro časový limit v milisekundách. Tato metoda nerozšíruje zásobník volání do pracovního vlákna.
UnsafeRegisterWaitForSingleObject(WaitHandle, WaitOrTimerCallback, Object, Int64, Boolean)	Zaregistruje delegáta pro čekání WaitHandlena , a určí 64bitové celé číslo se znaménkem pro časový limit v milisekundách. Tato metoda nerozšíruje zásobník volání do pracovního vlákna.
UnsafeRegisterWaitForSingleObject(WaitHandle, WaitOrTimerCallback, Object, UInt32, Boolean)	Zaregistruje delegáta pro čekání na WaitHandle, a určí 32bitové celé číslo bez znaménka pro časový limit v milisekundách. Tato metoda nerozšíruje zásobník volání do pracovního vlákna.

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

Zdroj:

ThreadPoolWorkQueue.cs

Zaregistruje delegáta, který bude čekat na WaitHandlea zadá TimeSpan hodnotu časového limitu. Tato metoda nerozšíruje zásobník volání do pracovního vlákna.

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);

[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
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

Parametry

waitObject

WaitHandle

K WaitHandle registraci. Použijte jiný než WaitHandleMutex.

callBack

WaitOrTimerCallback

Delegát, který se má volat při signálu parametru waitObject .

state

Object

Objekt, který je předán delegátu.

timeout

TimeSpan

Časový limit reprezentovaný TimeSpanhodnotou . Pokud timeout je 0 (nula), funkce otestuje stav objektu a okamžitě vrátí hodnotu. Pokud timeout je hodnota -1, časový limit funkce nikdy neuplyne.

executeOnlyOnce

Boolean

true k označení, že vlákno již nebude čekat na waitObject parametr po zavolání delegáta; false k označení, že časovač se resetuje při každém dokončení operace čekání, dokud se neregistruje čekání.

Návraty

RegisteredWaitHandle

Objekt RegisteredWaitHandle , který lze použít ke zrušení registrované operace čekání.

Atributy

UnsupportedOSPlatformAttribute

Výjimky

ArgumentOutOfRangeException

Parametr timeout je menší než -1.

NotSupportedException

Parametr timeout je větší než Int32.MaxValue.

SecurityException

Volající nemá požadované oprávnění.

Poznámky

RegisterWaitForSingleObject Na rozdíl od metody , UnsafeRegisterWaitForSingleObject nerozšíruje volací zásobník do pracovního vlákna. Díky tomu může kód ztratit volací zásobník a zvýšit tak svá oprávnění zabezpečení.

Upozornění

Použití UnsafeRegisterWaitForSingleObject by mohlo neúmyslně otevřít bezpečnostní díru. Zabezpečení přístupu kódu je při kontrolách oprávnění založená na oprávněních všech volajících v zásobníku. Pokud je práce zařazena do fronty ve vlákně fondu vláken pomocí UnsafeRegisterWaitForSingleObject, zásobník vlákna fondu vláken nebude mít kontext skutečných volajících. Tento škodlivý kód může zneužít, aby se vyhnul kontrolám oprávnění.

Mutex Použití pro waitObject neposkytuje vzájemné vyloučení pro zpětná volání, protože základní rozhraní API systému Windows používá výchozí WT_EXECUTEDEFAULT příznak, takže každé zpětné volání se odešle na samostatné vlákno fondu vláken.

Po dokončení použití , RegisteredWaitHandle který je vrácena touto metodou, voláním jeho RegisteredWaitHandle.Unregister metody uvolněte odkazy na popisovač čekání. Doporučujeme vždy volat metodu RegisteredWaitHandle.Unregister , a to i v případě, že zadáte true pro executeOnlyOnce. Uvolňování paměti funguje efektivněji, pokud voláte metodu RegisteredWaitHandle.Unregister místo závislosti na finalizační metodě registrovaného popisovače čekání.

Viz také

• Spravovaný fond vláken

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

Zdroj:

ThreadPoolWorkQueue.cs

Zaregistruje delegáta pro čekání WaitHandlena , s použitím 32bitového celého čísla se znaménkem pro časový limit v milisekundách. Tato metoda nerozšíruje zásobník volání do pracovního vlákna.

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);

[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
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

Parametry

waitObject

WaitHandle

K WaitHandle registraci. Použijte jiný než WaitHandleMutex.

callBack

WaitOrTimerCallback

Delegát, který se má volat při signálu parametru waitObject .

state

Object

Objekt, který je předán delegátu.

millisecondsTimeOutInterval

Int32

Časový limit v milisekundách. millisecondsTimeOutInterval Pokud je parametr 0 (nula), funkce otestuje stav objektu a okamžitě vrátí hodnotu . Pokud millisecondsTimeOutInterval je hodnota -1, časový limit funkce nikdy neuplyne.

executeOnlyOnce

Boolean

true k označení, že vlákno již nebude čekat na waitObject parametr po zavolání delegáta; false k označení, že časovač se resetuje při každém dokončení operace čekání, dokud se neregistruje čekání.

Návraty

RegisteredWaitHandle

Objekt RegisteredWaitHandle , který lze použít ke zrušení registrované operace čekání.

Atributy

UnsupportedOSPlatformAttribute

Výjimky

ArgumentOutOfRangeException

Parametr millisecondsTimeOutInterval je menší než -1.

SecurityException

Volající nemá požadované oprávnění.

Poznámky

RegisterWaitForSingleObject Na rozdíl od metody , UnsafeRegisterWaitForSingleObject nerozšíruje volací zásobník do pracovního vlákna. Díky tomu může kód ztratit volací zásobník a zvýšit tak svá oprávnění zabezpečení.

Upozornění

Použití UnsafeRegisterWaitForSingleObject by mohlo neúmyslně otevřít bezpečnostní díru. Zabezpečení přístupu kódu je při kontrolách oprávnění založená na oprávněních všech volajících v zásobníku. Pokud je práce zařazena do fronty ve vlákně fondu vláken pomocí UnsafeRegisterWaitForSingleObject, zásobník vlákna fondu vláken nebude mít kontext skutečných volajících. Tento škodlivý kód může zneužít, aby se vyhnul kontrolám oprávnění.

Mutex Použití pro waitObject neposkytuje vzájemné vyloučení pro zpětná volání, protože základní rozhraní API systému Windows používá výchozí WT_EXECUTEDEFAULT příznak, takže každé zpětné volání se odešle na samostatné vlákno fondu vláken.

Po dokončení použití , RegisteredWaitHandle který je vrácena touto metodou, voláním jeho RegisteredWaitHandle.Unregister metody uvolněte odkazy na popisovač čekání. Doporučujeme vždy volat metodu RegisteredWaitHandle.Unregister , a to i v případě, že zadáte true pro executeOnlyOnce. Uvolňování paměti funguje efektivněji, pokud voláte metodu RegisteredWaitHandle.Unregister místo závislosti na finalizační metodě registrovaného popisovače čekání.

Viz také

• Spravovaný fond vláken

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

Zdroj:

ThreadPoolWorkQueue.cs

Zaregistruje delegáta pro čekání WaitHandlena , a určí 64bitové celé číslo se znaménkem pro časový limit v milisekundách. Tato metoda nerozšíruje zásobník volání do pracovního vlákna.

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);

[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
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

Parametry

waitObject

WaitHandle

K WaitHandle registraci. Použijte jiný než WaitHandleMutex.

callBack

WaitOrTimerCallback

Delegát, který se má volat při signálu parametru waitObject .

state

Object

Objekt, který je předán delegátu.

millisecondsTimeOutInterval

Int64

Časový limit v milisekundách. millisecondsTimeOutInterval Pokud je parametr 0 (nula), funkce otestuje stav objektu a okamžitě vrátí hodnotu . Pokud millisecondsTimeOutInterval je hodnota -1, časový limit funkce nikdy neuplyne.

executeOnlyOnce

Boolean

true k označení, že vlákno již nebude čekat na waitObject parametr po zavolání delegáta; false k označení, že časovač se resetuje při každém dokončení operace čekání, dokud se neregistruje čekání.

Návraty

RegisteredWaitHandle

Objekt RegisteredWaitHandle , který lze použít ke zrušení registrované operace čekání.

Atributy

UnsupportedOSPlatformAttribute

Výjimky

ArgumentOutOfRangeException

Parametr millisecondsTimeOutInterval je menší než -1.

SecurityException

Volající nemá požadované oprávnění.

Poznámky

RegisterWaitForSingleObject Na rozdíl od metody , UnsafeRegisterWaitForSingleObject nerozšíruje volací zásobník do pracovního vlákna. Díky tomu může kód ztratit volací zásobník a zvýšit tak svá oprávnění zabezpečení.

Upozornění

Použití UnsafeRegisterWaitForSingleObject by mohlo neúmyslně otevřít bezpečnostní díru. Zabezpečení přístupu kódu je při kontrolách oprávnění založená na oprávněních všech volajících v zásobníku. Pokud je práce zařazena do fronty ve vlákně fondu vláken pomocí UnsafeRegisterWaitForSingleObject, zásobník vlákna fondu vláken nebude mít kontext skutečných volajících. Tento škodlivý kód může zneužít, aby se vyhnul kontrolám oprávnění.

Mutex Použití pro waitObject neposkytuje vzájemné vyloučení pro zpětná volání, protože základní rozhraní API systému Windows používá výchozí WT_EXECUTEDEFAULT příznak, takže každé zpětné volání se odešle na samostatné vlákno fondu vláken.

Po dokončení použití , RegisteredWaitHandle který je vrácena touto metodou, voláním jeho RegisteredWaitHandle.Unregister metody uvolněte odkazy na popisovač čekání. Doporučujeme vždy volat metodu RegisteredWaitHandle.Unregister , a to i v případě, že zadáte true pro executeOnlyOnce. Uvolňování paměti funguje efektivněji, pokud voláte metodu RegisteredWaitHandle.Unregister místo závislosti na finalizační metodě registrovaného popisovače čekání.

Viz také

• Spravovaný fond vláken

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

Zdroj:

ThreadPoolWorkQueue.cs

Důležité

Toto rozhraní API neodpovídá specifikaci CLS.

Zaregistruje delegáta, který bude čekat WaitHandlena , a zadá 32bitové celé číslo bez znaménka pro časový limit v milisekundách. Tato metoda nerozšíře zásobník volání do pracovního vlákna.

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)>]
[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
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

Parametry

waitObject

WaitHandle

K WaitHandle registraci. Použijte jiný než WaitHandleMutex.

callBack

WaitOrTimerCallback

Delegát, který se má volat při signálu parametru waitObject .

state

Object

Objekt, který je předán delegátu.

millisecondsTimeOutInterval

UInt32

Časový limit v milisekundách millisecondsTimeOutInterval Pokud je parametr 0 (nula), funkce otestuje stav objektu a vrátí okamžitě. Pokud millisecondsTimeOutInterval je hodnota -1, interval časového limitu funkce nikdy neuplyne.

executeOnlyOnce

Boolean

true to znamená, že vlákno už nebude čekat na waitObject parametr po zavolání delegáta. false Označuje, že se časovač resetuje při každém dokončení operace čekání, dokud se neregistruje čekání.

Návraty

RegisteredWaitHandle

Objekt RegisteredWaitHandle , který lze použít ke zrušení registrované operace čekání.

Atributy

CLSCompliantAttribute UnsupportedOSPlatformAttribute

Výjimky

SecurityException

Volající nemá požadované oprávnění.

Poznámky

RegisterWaitForSingleObject Na rozdíl od metody UnsafeRegisterWaitForSingleObject nešíře volaný zásobník do pracovního vlákna. To umožňuje kódu ztratit zásobník volání a tím zvýšit jeho oprávnění zabezpečení.

Upozornění

Použití UnsafeRegisterWaitForSingleObject by mohlo neúmyslně otevřít bezpečnostní díru. Zabezpečení přístupu kódu zakládá kontroly oprávnění na oprávněních všech volajících v zásobníku. Pokud je práce zařazena do fronty ve vlákně fondu vláken pomocí UnsafeRegisterWaitForSingleObject, zásobník vlákna fondu vláken nebude mít kontext skutečných volajících. Škodlivý kód může tuto možnost zneužít, aby se zabránilo kontrolám oprávnění.

Mutex Použití for waitObject neposkytuje vzájemné vyloučení pro zpětná volání, protože základní rozhraní API systému Windows používá výchozí WT_EXECUTEDEFAULT příznak, takže každé zpětné volání je odesláno na samostatné vlákno fondu vláken.

Po dokončení použití RegisteredWaitHandle , která je vrácena touto metodou, voláním jeho RegisteredWaitHandle.Unregister metody uvolněte odkazy na popisovač čekání. Doporučujeme vždy volat metodu RegisteredWaitHandle.Unregister , a to i v případě, že zadáte true pro executeOnlyOnce. Uvolňování paměti funguje efektivněji, pokud voláte metodu RegisteredWaitHandle.Unregister místo závislosti na finalizátoru registrovaného popisovače čekání.

Viz také

• Spravovaný fond vláken