SafeHandleZeroOrMinusOneIsInvalid Klass
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Tillhandahåller en basklass för implementeringar av säkra Win32-handtag där värdet för antingen 0 eller -1 anger ett ogiltigt handtag.
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- Arv
- Härledda
- Attribut
Kommentarer
Den här klassen härleds från klassen System.Runtime.InteropServices.SafeHandle. Den beskriver formatet för ett ogiltigt handtag. Vissa referenser använder till exempel -1 som ett ogiltigt referensvärde, medan andra använder 0. Ytterligare härledning av den här klassen (till exempel fil- eller registerreferenser) kan specialisera detta ytterligare. SafeFileHandle Se klassen för ett exempel på en klass som härleds från SafeHandleZeroOrMinusOneIsInvalid.
Important
Den här typen implementerar IDisposable gränssnittet. När du har använt typen bör du kassera den på ett direkt eller indirekt sätt. Om du vill ta bort typen direkt anropar du dess Dispose metod i ett try/catch block. Om du vill ta bort det indirekt använder du en språkkonstruktion som using (i C#) eller Using (i Visual Basic). Mer information finns i avsnittet "Använda ett objekt som implementerar IDisposable" i IDisposable gränssnittet.
SafeHandleZeroOrMinusOneIsInvalid Använd klassen när du behöver omsluta en ohanterad resurs på ett säkert sätt som inte har någon befintlig hanterad omslutning.
Konstruktorer
| Name | Description |
|---|---|
| SafeHandleZeroOrMinusOneIsInvalid(Boolean) |
Initierar en ny instans av SafeHandleZeroOrMinusOneIsInvalid klassen och anger om handtaget ska släppas på ett tillförlitligt sätt. |
Fält
| Name | Description |
|---|---|
| handle |
Anger det handtag som ska omslutas. (Ärvd från SafeHandle) |
Egenskaper
| Name | Description |
|---|---|
| IsClosed |
Hämtar ett värde som anger om handtaget är stängt. (Ärvd från SafeHandle) |
| IsInvalid |
Hämtar ett värde som anger om handtaget är ogiltigt. |
Metoder
| Name | Description |
|---|---|
| Close() |
Markerar handtaget för att frigöra och frigöra resurser. (Ärvd från SafeHandle) |
| DangerousAddRef(Boolean) |
Ökar referensräknaren manuellt på SafeHandle instanser. (Ärvd från SafeHandle) |
| DangerousGetHandle() |
Returnerar värdet för fältet handle . (Ärvd från SafeHandle) |
| DangerousRelease() |
Manuellt minskar referensräknaren på en SafeHandle instans. (Ärvd från SafeHandle) |
| Dispose() |
Släpper alla resurser som används av SafeHandle klassen. (Ärvd från SafeHandle) |
| Dispose(Boolean) |
Släpper de ohanterade resurser som används av SafeHandle klassen och anger om en normal borttagning ska utföras. (Ärvd från SafeHandle) |
| Equals(Object) |
Avgör om det angivna objektet är lika med det aktuella objektet. (Ärvd från Object) |
| GetHashCode() |
Fungerar som standard-hash-funktion. (Ärvd från Object) |
| GetType() |
Hämtar den aktuella instansen Type . (Ärvd från Object) |
| MemberwiseClone() |
Skapar en ytlig kopia av den aktuella Object. (Ärvd från Object) |
| ReleaseHandle() |
När den åsidosättas i en härledd klass kör den kod som krävs för att frigöra handtaget. (Ärvd från SafeHandle) |
| SetHandle(IntPtr) |
Anger referensen till det angivna befintliga handtaget. (Ärvd från SafeHandle) |
| SetHandleAsInvalid() |
Markerar ett handtag som inte längre används. (Ärvd från SafeHandle) |
| ToString() |
Returnerar en sträng som representerar det aktuella objektet. (Ärvd från Object) |