SafeHandleZeroOrMinusOneIsInvalid Klasse
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Stellt eine Basisklasse für sichere Handleimplementierungen von Win32 bereit, bei denen der Wert von 0 oder -1 einen ungültigen Handle angibt.
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- Vererbung
- Abgeleitet
- Attribute
Hinweise
Diese Klasse wird von der System.Runtime.InteropServices.SafeHandle-Klasse abgeleitet. Es beschreibt das Format eines ungültigen Handles. Beispielsweise verwenden einige Handles -1 als ungültigen Handlewert, während andere 0 verwenden. Weitere Ableitungen dieser Klasse (z. B. Datei- oder Registrierungshandles) können dies weiter spezialisieren. Sehen Sie sich die SafeFileHandle Klasse an, um ein Beispiel für eine Klasse zu erhalten, die von SafeHandleZeroOrMinusOneIsInvalid.
Important
Dieser Typ implementiert die IDisposable Schnittstelle. Nach Abschluss der Verwendung sollten Sie den Typ entweder direkt oder indirekt löschen. Rufen Sie die Methode Dispose in einem try/catch-Block auf, um den Typ direkt zu entsorgen. Verwenden Sie zum indirekten Löschen ein Sprachkonstrukt wie using (in C#) oder Using (in Visual Basic). Weitere Informationen finden Sie im Abschnitt "Verwenden eines Objekts, das IDisposable implementiert" im IDisposable Schnittstellenthema.
Verwenden Sie die SafeHandleZeroOrMinusOneIsInvalid Klasse, wenn Sie eine nicht verwaltete Ressource sicher umschließen müssen, die nicht über einen vorhandenen verwalteten Wrapper verfügt.
Konstruktoren
| Name | Beschreibung |
|---|---|
| SafeHandleZeroOrMinusOneIsInvalid(Boolean) |
Initialisiert eine neue Instanz der SafeHandleZeroOrMinusOneIsInvalid Klasse, die angibt, ob das Handle zuverlässig freigegeben werden soll. |
Felder
| Name | Beschreibung |
|---|---|
| handle |
Gibt das Handle an, das umschlossen werden soll. (Geerbt von SafeHandle) |
Eigenschaften
| Name | Beschreibung |
|---|---|
| IsClosed |
Ruft einen Wert ab, der angibt, ob das Handle geschlossen ist. (Geerbt von SafeHandle) |
| IsInvalid |
Ruft einen Wert ab, der angibt, ob das Handle ungültig ist. |
Methoden
| Name | Beschreibung |
|---|---|
| Close() |
Markiert das Handle zum Freigeben und Freigeben von Ressourcen. (Geerbt von SafeHandle) |
| DangerousAddRef(Boolean) |
Erhöht den Verweiszähler manuell auf SafeHandle Instanzen. (Geerbt von SafeHandle) |
| DangerousGetHandle() |
Gibt den Wert des handle Felds zurück. (Geerbt von SafeHandle) |
| DangerousRelease() |
Erhöht manuell den Verweiszähler für eine SafeHandle Instanz. (Geerbt von SafeHandle) |
| Dispose() |
Gibt alle Ressourcen frei, die von der SafeHandle-Klasse verwendet werden. (Geerbt von SafeHandle) |
| Dispose(Boolean) |
Gibt die von der Klasse verwendeten nicht verwalteten Ressourcen frei, die SafeHandle angeben, ob ein normaler Dispose-Vorgang ausgeführt werden soll. (Geerbt von SafeHandle) |
| Equals(Object) |
Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object) |
| GetHashCode() |
Dient als Standardhashfunktion. (Geerbt von Object) |
| GetType() |
Ruft die Type der aktuellen Instanz ab. (Geerbt von Object) |
| MemberwiseClone() |
Erstellt eine flache Kopie der aktuellen Object. (Geerbt von Object) |
| ReleaseHandle() |
Wenn sie in einer abgeleiteten Klasse überschrieben wird, wird der code ausgeführt, der zum Freigeben des Handles erforderlich ist. (Geerbt von SafeHandle) |
| SetHandle(IntPtr) |
Legt den Handle auf den angegebenen vordefinierten Handle fest. (Geerbt von SafeHandle) |
| SetHandleAsInvalid() |
Markiert einen Handle als nicht mehr verwendet. (Geerbt von SafeHandle) |
| ToString() |
Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object) |