SafeHandle.DangerousAddRef(Boolean) Metoda

Definice

Obor názvů:
System.Runtime.InteropServices
Sestavení:
mscorlib.dll, System.Runtime.Handles.dll
Sestavení:
netstandard.dll, System.Runtime.dll
Sestavení:
System.Runtime.Handles.dll
Sestavení:
System.Runtime.dll
Sestavení:
mscorlib.dll
Sestavení:
System.Runtime.InteropServices.dll
Sestavení:
netstandard.dll
Zdroj:
SafeHandle.cs
Zdroj:
SafeHandle.cs
Zdroj:
SafeHandle.cs
Zdroj:
SafeHandle.cs
Zdroj:
SafeHandle.cs

Ručně zvýší referenční čítač instancí SafeHandle .

public:
 void DangerousAddRef(bool % success);
[System.Security.SecurityCritical]
public void DangerousAddRef(ref bool success);
public void DangerousAddRef(ref bool success);
[<System.Security.SecurityCritical>]
member this.DangerousAddRef : bool -> unit
member this.DangerousAddRef : bool -> unit
Public Sub DangerousAddRef (ByRef success As Boolean)

Parametry

success
Boolean

truepokud byl referenční čítač úspěšně zvýšit; v opačném případě . false

Atributy
SecurityCriticalAttribute

Výjimky

ObjectDisposedException

SafeHandle byl odstraněn.

Poznámky

Tato DangerousAddRef metoda zabraňuje modulu CLR (Common Language Runtime) uvolnit paměť používanou popisovačem (ke kterému dochází při volání ReleaseHandle metody za běhu). Tuto metodu můžete použít k ručnímu zvýšení počtu odkazů na SafeHandle instanci. DangerousAddRef vrátí logickou hodnotu pomocí parametru ref (success), který označuje, zda byl počet odkazů úspěšně zvýšení. To umožňuje, aby se logika programu vrátila v případě selhání. Před voláním successbyste měli nastavit false hodnotu DangerousAddRef . Pokud success ano true, vyhněte se úniku prostředků tím, že odpovídá volání DangerousAddRef s odpovídajícím voláním DangerousRelease.

Pokud je toto volání úspěšné, nastaví ref bool success parametr na true hodnotu a vrátí se úspěšně. Pokud je toto volání neúspěšné, vyvolá výjimku a parametr ponechá ref bool success nezměněný.

Platí pro

Viz také