Udostępnij za pośrednictwem


SafeHandleZeroOrMinusOneIsInvalid Klasa

Definicja

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::SafeHandle
public abstract class SafeHandleZeroOrMinusOneIsInvalid : System.Runtime.InteropServices.SafeHandle
[System.Security.SecurityCritical]
public abstract class SafeHandleZeroOrMinusOneIsInvalid : System.Runtime.InteropServices.SafeHandle
type SafeHandleZeroOrMinusOneIsInvalid = class
    inherit SafeHandle
[<System.Security.SecurityCritical>]
type SafeHandleZeroOrMinusOneIsInvalid = class
    inherit SafeHandle
Public MustInherit Class SafeHandleZeroOrMinusOneIsInvalid
Inherits SafeHandle
Dziedziczenie
SafeHandleZeroOrMinusOneIsInvalid
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)

Dotyczy

Zobacz też