SafeHandle.DangerousAddRef(Boolean) Metoda

Definicja

Przestrzeń nazw:

System.Runtime.InteropServices

Zestaw:

System.Runtime.dll

Źródło:

SafeHandle.cs

Ręczne zwiększanie licznika odwołania w SafeHandle wystąpieniach.

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

true jeśli licznik odwołań został pomyślnie zwiększany; w przeciwnym razie , false.

Wyjątki

ObjectDisposedException

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.

Zobacz też

• DangerousRelease()