SafeHandleMinusOneIsInvalid 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, in denen der Wert von -1 einen ungültigen Handle angibt.
public ref class SafeHandleMinusOneIsInvalid abstract : System::Runtime::InteropServices::SafeHandle
public abstract class SafeHandleMinusOneIsInvalid : System.Runtime.InteropServices.SafeHandle
[System.Security.SecurityCritical]
public abstract class SafeHandleMinusOneIsInvalid : System.Runtime.InteropServices.SafeHandle
type SafeHandleMinusOneIsInvalid = class
inherit SafeHandle
[<System.Security.SecurityCritical>]
type SafeHandleMinusOneIsInvalid = class
inherit SafeHandle
Public MustInherit Class SafeHandleMinusOneIsInvalid
Inherits SafeHandle
- Vererbung
- Attribute
Hinweise
Diese Klasse wird von der System.Runtime.InteropServices.SafeHandle-Klasse abgeleitet. Es beschreibt das Format eines ungültigen Handles, das einen Wert von -1 verwendet. 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 SafeHandleMinusOneIsInvalid.
Warnung
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.
Konstruktoren
| Name | Beschreibung |
|---|---|
| SafeHandleMinusOneIsInvalid(Boolean) |
Initialisiert eine neue Instanz der SafeHandleMinusOneIsInvalid 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) |