SafeHandle.DangerousAddRef(Boolean) Metoda
Definice
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 -> unitmember this.DangerousAddRef : bool -> unitPublic 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
- Atributy
Výjimky
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.
