SafeHandle.DangerousAddRef(Boolean) Metoda

Definice

Obor názvů:

System.Runtime.InteropServices

Sestavení:

System.Runtime.dll

Zdroj:

SafeHandle.cs

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

public:
 void DangerousAddRef(bool % success);

public void DangerousAddRef (ref bool success);

member this.DangerousAddRef : bool -> unit

Public Sub DangerousAddRef (ByRef success As Boolean)

Parametry

success

Boolean

truebyl-li počitadlo odkazu úspěšně navýšován; v opačném případě . false

Výjimky

ObjectDisposedException

SafeHandle byl odstraněn.

Poznámky

Metoda DangerousAddRef zabraňuje modulu CLR (Common Language Runtime) v uvolnění paměti používané 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. Díky tomu může logika programu v případě selhání ustoupit. Před voláním DangerousAddRefbyste měli nastavit success na false hodnotu . Pokud success je true, vyhněte se nevracení prostředků tím, že DangerousAddRef se volání shoduje s odpovídajícím voláním DangerousRelease.

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

Viz také

• DangerousRelease()