SafeHandleZeroOrMinusOneIsInvalid Klasa
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.
Zapewnia klasę bazową dla implementacji bezpiecznego uchwytu Win32, w których wartość 0 lub -1 wskazuje nieprawidłowy uchwyt.
public ref class SafeHandleZeroOrMinusOneIsInvalid abstract : System::Runtime::InteropServices::SafeHandlepublic abstract class SafeHandleZeroOrMinusOneIsInvalid : System.Runtime.InteropServices.SafeHandle[System.Security.SecurityCritical]
public abstract class SafeHandleZeroOrMinusOneIsInvalid : System.Runtime.InteropServices.SafeHandletype SafeHandleZeroOrMinusOneIsInvalid = class
inherit SafeHandle[<System.Security.SecurityCritical>]
type SafeHandleZeroOrMinusOneIsInvalid = class
inherit SafeHandlePublic MustInherit Class SafeHandleZeroOrMinusOneIsInvalid
Inherits SafeHandle- Dziedziczenie
- Pochodne
- Atrybuty
Uwagi
Ta klasa pochodzi z System.Runtime.InteropServices.SafeHandle klasy . Opisuje format nieprawidłowego uchwytu. Na przykład niektóre uchwyty używają -1 jako nieprawidłowej wartości uchwytu, a inne używają wartości 0. Dalsze wyprowadzenia tej klasy (na przykład dojścia do plików lub rejestrów) mogą dodatkowo je specjalizować. Zobacz klasę SafeFileHandle , aby zapoznać się z przykładem klasy pochodzącej z SafeHandleZeroOrMinusOneIsInvalidklasy .
Ważne
Ten typ implementuje IDisposable interfejs. Po zakończeniu korzystania z typu należy go usunąć bezpośrednio lub pośrednio. Aby usunąć typ bezpośrednio, wywołaj metodę Disposetry/catch w bloku. Aby usunąć go pośrednio, użyj konstrukcji językowej, takiej jak using (w języku C#) lub Using (w Visual Basic). Aby uzyskać więcej informacji, zobacz sekcję "Using an Object that Implements IDisposable" (Używanie obiektu implementujące protokół IDisposable) w temacie interfejsu IDisposable .
SafeHandleZeroOrMinusOneIsInvalid Użyj klasy zawsze, gdy musisz bezpiecznie opakowować niezarządzany zasób, który nie ma istniejącej otoki zarządzanej.
Konstruktory
| SafeHandleZeroOrMinusOneIsInvalid(Boolean) |
Inicjuje SafeHandleZeroOrMinusOneIsInvalid nowe wystąpienie klasy, określając, czy uchwyt ma być niezawodnie zwolniony. |
Pola
| handle |
Określa uchwyt, który ma być opakowany. (Odziedziczone po SafeHandle) |
Właściwości
| IsClosed |
Pobiera wartość wskazującą, czy uchwyt jest zamknięty. (Odziedziczone po SafeHandle) |
| IsInvalid |
Pobiera wartość wskazującą, czy uchwyt jest nieprawidłowy. |
Metody
| Close() |
Oznacza uchwyt do zwalniania i zwalniania zasobów. (Odziedziczone po SafeHandle) |
| DangerousAddRef(Boolean) |
Ręczne zwiększanie licznika odwołania w SafeHandle wystąpieniach. (Odziedziczone po SafeHandle) |
| DangerousGetHandle() |
Zwraca wartość handle pola. (Odziedziczone po SafeHandle) |
| DangerousRelease() |
Ręczne dekrementuje licznik odwołań w wystąpieniu SafeHandle . (Odziedziczone po SafeHandle) |
| Dispose() |
Zwalnia wszystkie zasoby używane przez klasę SafeHandle . (Odziedziczone po SafeHandle) |
| Dispose(Boolean) |
Zwalnia niezarządzane zasoby używane przez klasę SafeHandle określającą, czy wykonać normalną operację usuwania. (Odziedziczone po SafeHandle) |
| Equals(Object) |
Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object) |
| GetHashCode() |
Służy jako domyślna funkcja skrótu. (Odziedziczone po Object) |
| GetType() |
Type Pobiera bieżące wystąpienie. (Odziedziczone po Object) |
| MemberwiseClone() |
Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object) |
| ReleaseHandle() |
Po zastąpieniu w klasie pochodnej wykonuje kod wymagany do zwolnienia uchwytu. (Odziedziczone po SafeHandle) |
| SetHandle(IntPtr) |
Ustawia uchwyt do określonego wstępnie istniejącego uchwytu. (Odziedziczone po SafeHandle) |
| SetHandleAsInvalid() |
Oznacza uchwyt jako nieużytny. (Odziedziczone po SafeHandle) |
| ToString() |
Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object) |
