SafeHandle.DangerousAddRef(Boolean) Metoda

Reference

Definice

Obor názvů:: System.Runtime.InteropServices

Sestavení:: mscorlib.dll, System.Runtime.Handles.dll

Sestavení:: System.Runtime.dll

Sestavení:: System.Runtime.Handles.dll

Sestavení:: mscorlib.dll

Sestavení:: System.Runtime.InteropServices.dll

Sestavení:: netstandard.dll

Zdroj:: SafeHandle.cs

Zdroj:: SafeHandle.cs

Zdroj:: SafeHandle.cs

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Ručně zvýší čítač odkazů na SafeHandle instance.

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 čítač odkazu úspěšně zvyšován; v opačném případě . false

Atributy: SecurityCriticalAttribute

Výjimky

ObjectDisposedException

SafeHandle byl odstraněn.

Poznámky

Metoda DangerousAddRef zabraňuje modulu CLR (Common Language Runtime) v uvolnění paměti využité popisovačem (k čemuž dochází, když modul runtime volá metodu ReleaseHandle ). 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ě zvyšován. To umožňuje, aby logika programu v případě selhání ustoupit. Před voláním DangerousAddRefpříkazu byste měli nastavit success na false hodnotu . Pokud success je true, vyhněte se nevracení prostředků tím, že se volání shoduje DangerousAddRef s odpovídajícím voláním DangerousRelease.

Pokud je toto volání úspěšné, nastaví parametr na ref bool successtrue 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é

DangerousRelease()