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
Wyjątki
SafeHandle został usunięty.
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 Metoda 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.
Jeśli to wywołanie powiedzie się, ustawi ref bool success parametr na true i zwróci pomyślnie. Jeśli to wywołanie nie powiedzie się, zgłosi wyjątek i pozostawi ref bool success parametr niezmodyfikowany.
