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 -> unit
member this.DangerousAddRef : bool -> unit
Public Sub DangerousAddRef (ByRef success As Boolean)
Parametry
- success
- Boolean
true
jeśli licznik odwołań został pomyślnie przyrostowany; w przeciwnym razie , false
.
- Atrybuty
Wyjątki
SafeHandle został usunięty.
Uwagi
Metoda DangerousAddRef uniemożliwia środowisko uruchomieniowe języka wspólnego odzyskanie pamięci używanej przez uchwyt (który występuje, gdy środowisko uruchomieniowe wywołuje metodę ReleaseHandle ). Tej metody można użyć do ręcznego przyrostu 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ększona. Dzięki temu logika programu może wycofać się w przypadku awarii. Przed wywołaniem DangerousAddRefmetody należy ustawić wartość .success
false
Jeśli success
jest to true
, unikaj wycieków zasobów, pasując do wywołania z DangerousAddRef odpowiednim wywołaniem do DangerousRelease.
Jeśli to wywołanie zakończy się pomyślnie, 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.
Dotyczy
Zobacz też
Opinia
https://aka.ms/ContentUserFeedback.
Dostępne już wkrótce: W 2024 r. będziemy stopniowo wycofywać zgłoszenia z serwisu GitHub jako mechanizm przesyłania opinii na temat zawartości i zastępować go nowym systemem opinii. Aby uzyskać więcej informacji, sprawdź:Prześlij i wyświetl opinię dla