SafeHandle.SetHandleAsInvalid 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.
Oznacza uchwyt jako nieużytny.
public:
void SetHandleAsInvalid();
[System.Security.SecurityCritical]
public void SetHandleAsInvalid ();
public void SetHandleAsInvalid ();
[<System.Security.SecurityCritical>]
member this.SetHandleAsInvalid : unit -> unit
member this.SetHandleAsInvalid : unit -> unit
Public Sub SetHandleAsInvalid ()
- Atrybuty
Uwagi
Wywołaj metodę SetHandleAsInvalid tylko wtedy, gdy wiesz, że uchwyt nie odwołuje się już do zasobu. W ten sposób nie zmienia wartości handle pola; oznacza tylko uchwyt jako zamknięty. Uchwyt może następnie zawierać potencjalnie nieaktualną wartość. Efektem tego wywołania jest to, że nie podjęto próby zwolnienia zasobów.
Podobnie jak w przypadku SetHandle metody, należy użyć SetHandleAsInvalid tylko wtedy, gdy potrzebujesz obsługi wstępnie istniejącego uchwytu.