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.
Udostępnia 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 dojścia używają -1 jako nieprawidłowej wartości dojścia, podczas gdy inne używają wartości 0. Dalsze wyprowadzenia tej klasy (na przykład dojścia do plików lub rejestru) mogą jeszcze bardziej specjalizować tę klasę. Zobacz klasę SafeFileHandle , aby zapoznać się z przykładem klasy pochodzącej z klasy SafeHandleZeroOrMinusOneIsInvalid.
Ważna
Ten typ implementuje interfejs IDisposable. Po zakończeniu korzystania z typu danych, należy go usunąć w sposób bezpośredni lub pośredni. Aby usunąć typ bezpośrednio, wywołaj metodę Dispose w bloku try/catch. Aby usunąć go pośrednio, należy użyć konstrukcji języka, takiej jak using (w języku C#) lub Using (w Visual Basic). Aby uzyskać więcej informacji, zobacz sekcję "Używanie obiektu implementującego IDisposable" (Using an Object that Implements IDisposable) w temacie interfejsu IDisposable.
SafeHandleZeroOrMinusOneIsInvalid Użyj klasy zawsze, gdy musisz bezpiecznie opakowować niezarządzany zasób, który nie ma istniejącej zarządzanej otoki.
Konstruktory
| Nazwa | Opis |
|---|---|
| SafeHandleZeroOrMinusOneIsInvalid(Boolean) |
Inicjuje SafeHandleZeroOrMinusOneIsInvalid nowe wystąpienie klasy, określając, czy uchwyt ma zostać niezawodnie zwolniony. |
Pola
| Nazwa | Opis |
|---|---|
| handle |
Określa uchwyt, który ma być opakowany. (Odziedziczone po SafeHandle) |
Właściwości
| Nazwa | Opis |
|---|---|
| IsClosed |
Pobiera wartość wskazującą, czy uchwyt jest zamknięty. (Odziedziczone po SafeHandle) |
| IsInvalid |
Pobiera wartość wskazującą, czy uchwyt jest nieprawidłowy. |
Metody
| Nazwa | Opis |
|---|---|
| Close() |
Oznacza dojście 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 określony obiekt jest równy bieżącemu obiektowi. (Odziedziczone po Object) |
| GetHashCode() |
Służy jako domyślna funkcja skrótu. (Odziedziczone po Object) |
| GetType() |
Pobiera Type bieżącego wystąpienia. (Odziedziczone po Object) |
| MemberwiseClone() |
Tworzy płytkią kopię bieżącego Object. (Odziedziczone po Object) |
| ReleaseHandle() |
Po zastąpieniu w klasie pochodnej wykonuje kod wymagany do zwolnienia uchwytu. (Odziedziczone po SafeHandle) |
| SetHandle(IntPtr) |
Ustawia dojście 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) |
