SafeHandle.DangerousAddRef(Boolean) Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Ręczne zwiększanie licznika odwołania w SafeHandle wystąpieniach.
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
true jeśli licznik odwołań został pomyślnie zwiększany; w przeciwnym razie , false.
- Atrybuty
Uwagi
Metoda DangerousAddRef uniemożliwia środowisku uruchomieniowemu języka wspólnego odzyskiwanie pamięci używanej przez uchwyt (który występuje, gdy środowisko uruchomieniowe wywołuje metodę ReleaseHandle ). Ta metoda umożliwia ręczne zwiększanie liczby odwołań w wystąpieniu SafeHandle . DangerousAddRef Zwraca wartość logiczną przy użyciu parametru ref (success), który wskazuje, czy liczba odwołań została pomyślnie zwiększana. Dzięki temu logika programu może wycofać się w przypadku awarii. Przed wywołaniem metody DangerousAddRefnależy ustawić false wartość success na . Jeśli success parametr ma truewartość , należy unikać przecieków zasobów, dopasowując wywołanie metody do DangerousAddRef elementu z odpowiednim wywołaniem metody DangerousRelease.
Przestroga
Ta metoda jest przeznaczona dla zaawansowanych użytkowników i musi być zawsze używana ostrożnie. Aby uniknąć wycieku zasobów dojścia, zawsze należy wywołać tę metodę wewnątrz ograniczonego regionu wykonywania (CER), w którym przerwanie wątku nie może przerwać przetwarzania.