ThreadPool.UnsafeRegisterWaitForSingleObject Metoda

Definice

Obor názvů:

System.Threading

Sestavení:

netstandard.dll, System.Threading.ThreadPool.dll

Zaregistruje delegáta, aby čekal na , WaitHandleale nerozšíře volající zásobník do pracovního vlákna.

Přetížení

Name	Description
UnsafeRegisterWaitForSingleObject(WaitHandle, WaitOrTimerCallback, Object, TimeSpan, Boolean)	Zaregistruje delegáta, který bude čekat na WaitHandleTimeSpan hodnotu časového limitu. Tato metoda nešíruje volající zásobník do pracovního vlákna.
UnsafeRegisterWaitForSingleObject(WaitHandle, WaitOrTimerCallback, Object, Int32, Boolean)	Zaregistruje delegáta, aby počkal na WaitHandle32bitové celé číslo se znaménkem pro vypršení časového limitu v milisekundách. Tato metoda nešíruje volající zásobník do pracovního vlákna.
UnsafeRegisterWaitForSingleObject(WaitHandle, WaitOrTimerCallback, Object, Int64, Boolean)	Zaregistruje delegáta, který bude čekat na WaitHandle64bitové celé číslo se znaménkem pro vypršení časového limitu v milisekundách. Tato metoda nešíruje volající zásobník do pracovního vlákna.
UnsafeRegisterWaitForSingleObject(WaitHandle, WaitOrTimerCallback, Object, UInt32, Boolean)	Zaregistruje delegáta, který bude čekat na WaitHandle32bitové celé číslo bez znaménka pro časový limit v milisekundách. Tato metoda nešíruje volající zásobník do pracovního vlákna.

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

Zdroj:

ThreadPoolWorkQueue.cs

Zaregistruje delegáta, který bude čekat na WaitHandleTimeSpan hodnotu časového limitu. Tato metoda nešíruje volající zásobník 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

Registrace WaitHandle . Použijte jiné než WaitHandleMutex.

callBack

WaitOrTimerCallback

Delegát, který má volat, když waitObject je parametr signalován.

state

Object

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

timeout

TimeSpan

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

executeOnlyOnce

Boolean

true chcete-li označit, že vlákno již nebude čekat na waitObject parametr po zavolání delegáta; false aby indikoval, že časovač je resetován při každém dokončení operace čekání, dokud se čekání neregistruje.

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 nešíruje volající zásobník do pracovního vlákna. To umožňuje kódu ztratit volající zásobník a tím zvýšit jeho oprávnění zabezpečení.

Caution

Použití UnsafeRegisterWaitForSingleObject by mohlo neúmyslně otevřít bezpečnostní díru. Zabezpečení přístupu kódu zakládá svá 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 by mohl zneužít, aby se zabránilo kontrolám oprávnění.

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

Jakmile budete hotovi pomocí metody RegisteredWaitHandle , která je vrácena touto metodou, zavolejte její RegisteredWaitHandle.Unregister metodu uvolnění odkazů na popisovač čekání. Doporučujeme vždy volat metodu RegisteredWaitHandle.Unregister , i když zadáte true pro executeOnlyOnce. Uvolňování paměti funguje efektivněji, pokud voláte metodu RegisteredWaitHandle.Unregister místo v závislosti na finalizátoru registrovaného obslužného rutiny čekání.

Viz také

• Fond spravovaných vláken

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

Zdroj:

ThreadPoolWorkQueue.cs

Zaregistruje delegáta, aby počkal na WaitHandle32bitové celé číslo se znaménkem pro vypršení časového limitu v milisekundách. Tato metoda nešíruje volající zásobník 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

Registrace WaitHandle . Použijte jiné než WaitHandleMutex.

callBack

WaitOrTimerCallback

Delegát, který má volat, když waitObject je parametr signalován.

state

Object

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

millisecondsTimeOutInterval

Int32

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

executeOnlyOnce

Boolean

true chcete-li označit, že vlákno již nebude čekat na waitObject parametr po zavolání delegáta; false aby indikoval, že časovač je resetován při každém dokončení operace čekání, dokud se čekání neregistruje.

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 nešíruje volající zásobník do pracovního vlákna. To umožňuje kódu ztratit volající zásobník a tím zvýšit jeho oprávnění zabezpečení.

Caution

Použití UnsafeRegisterWaitForSingleObject by mohlo neúmyslně otevřít bezpečnostní díru. Zabezpečení přístupu kódu zakládá svá 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 by mohl zneužít, aby se zabránilo kontrolám oprávnění.

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

Jakmile budete hotovi pomocí metody RegisteredWaitHandle , která je vrácena touto metodou, zavolejte její RegisteredWaitHandle.Unregister metodu uvolnění odkazů na popisovač čekání. Doporučujeme vždy volat metodu RegisteredWaitHandle.Unregister , i když zadáte true pro executeOnlyOnce. Uvolňování paměti funguje efektivněji, pokud voláte metodu RegisteredWaitHandle.Unregister místo v závislosti na finalizátoru registrovaného obslužného rutiny čekání.

Viz také

• Fond spravovaných vláken

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

Zdroj:

ThreadPoolWorkQueue.cs

Zaregistruje delegáta, který bude čekat na WaitHandle64bitové celé číslo se znaménkem pro vypršení časového limitu v milisekundách. Tato metoda nešíruje volající zásobník 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

Registrace WaitHandle . Použijte jiné než WaitHandleMutex.

callBack

WaitOrTimerCallback

Delegát, který má volat, když waitObject je parametr signalován.

state

Object

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

millisecondsTimeOutInterval

Int64

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

executeOnlyOnce

Boolean

true chcete-li označit, že vlákno již nebude čekat na waitObject parametr po zavolání delegáta; false aby indikoval, že časovač je resetován při každém dokončení operace čekání, dokud se čekání neregistruje.

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 nešíruje volající zásobník do pracovního vlákna. To umožňuje kódu ztratit volající zásobník a tím zvýšit jeho oprávnění zabezpečení.

Caution

Použití UnsafeRegisterWaitForSingleObject by mohlo neúmyslně otevřít bezpečnostní díru. Zabezpečení přístupu kódu zakládá svá 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 by mohl zneužít, aby se zabránilo kontrolám oprávnění.

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

Jakmile budete hotovi pomocí metody RegisteredWaitHandle , která je vrácena touto metodou, zavolejte její RegisteredWaitHandle.Unregister metodu uvolnění odkazů na popisovač čekání. Doporučujeme vždy volat metodu RegisteredWaitHandle.Unregister , i když zadáte true pro executeOnlyOnce. Uvolňování paměti funguje efektivněji, pokud voláte metodu RegisteredWaitHandle.Unregister místo v závislosti na finalizátoru registrovaného obslužného rutiny čekání.

Viz také

• Fond spravovaných 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 na WaitHandle32bitové celé číslo bez znaménka pro časový limit v milisekundách. Tato metoda nešíruje volající zásobník 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

Registrace WaitHandle . Použijte jiné než WaitHandleMutex.

callBack

WaitOrTimerCallback

Delegát, který má volat, když waitObject je parametr signalován.

state

Object

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

millisecondsTimeOutInterval

UInt32

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

executeOnlyOnce

Boolean

true chcete-li označit, že vlákno již nebude čekat na waitObject parametr po zavolání delegáta; false aby indikoval, že časovač je resetován při každém dokončení operace čekání, dokud se čekání neregistruje.

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šíruje volající zásobník do pracovního vlákna. To umožňuje kódu ztratit volající zásobník a tím zvýšit jeho oprávnění zabezpečení.

Caution

Použití UnsafeRegisterWaitForSingleObject by mohlo neúmyslně otevřít bezpečnostní díru. Zabezpečení přístupu kódu zakládá svá 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 by mohl zneužít, aby se zabránilo kontrolám oprávnění.

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

Jakmile budete hotovi pomocí metody RegisteredWaitHandle , která je vrácena touto metodou, zavolejte její RegisteredWaitHandle.Unregister metodu uvolnění odkazů na popisovač čekání. Doporučujeme vždy volat metodu RegisteredWaitHandle.Unregister , i když zadáte true pro executeOnlyOnce. Uvolňování paměti funguje efektivněji, pokud voláte metodu RegisteredWaitHandle.Unregister místo v závislosti na finalizátoru registrovaného obslužného rutiny čekání.

Viz také

• Fond spravovaných vláken