SafeRegistryHandle 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 ein sicheres Handle für die Windows Registrierung dar.
public ref class SafeRegistryHandle sealed : Microsoft::Win32::SafeHandles::SafeHandleZeroOrMinusOneIsInvalidpublic ref class SafeRegistryHandle sealed : System::Runtime::InteropServices::SafeHandlepublic sealed class SafeRegistryHandle : Microsoft.Win32.SafeHandles.SafeHandleZeroOrMinusOneIsInvalid[System.Security.SecurityCritical]
public sealed class SafeRegistryHandle : System.Runtime.InteropServices.SafeHandle[System.Security.SecurityCritical]
public sealed class SafeRegistryHandle : Microsoft.Win32.SafeHandles.SafeHandleZeroOrMinusOneIsInvalidtype SafeRegistryHandle = class
inherit SafeHandleZeroOrMinusOneIsInvalid[<System.Security.SecurityCritical>]
type SafeRegistryHandle = class
inherit SafeHandle[<System.Security.SecurityCritical>]
type SafeRegistryHandle = class
inherit SafeHandleZeroOrMinusOneIsInvalidPublic NotInheritable Class SafeRegistryHandle
Inherits SafeHandleZeroOrMinusOneIsInvalidPublic NotInheritable Class SafeRegistryHandle
Inherits SafeHandle- Vererbung
- Vererbung
- Attribute
Hinweise
Sie können den Plattformaufruf für die systemeigene RegCreateKeyEx Windows-Funktion verwenden, um ein SafeRegistryHandle-Objekt abzurufen und dann Registrierungsschlüssel mit der RegistryKey.FromHandle-Methode zu erstellen.
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.
Konstruktoren
| Name | Beschreibung |
|---|---|
| SafeRegistryHandle() |
Erstellt eine SafeRegistryHandle. |
| SafeRegistryHandle(IntPtr, Boolean) |
Initialisiert eine neue Instanz der SafeRegistryHandle-Klasse. |
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. |
| IsInvalid |
Ruft einen Wert ab, der angibt, ob das Handle ungültig ist. (Geerbt von SafeHandleZeroOrMinusOneIsInvalid) |
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 dem aktuellen Objekt entspricht. (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) |
