SafeHandleZeroOrMinusOneIsInvalid Classe

  • Riferimento

Definizione

Spazio dei nomi:
Microsoft.Win32.SafeHandles
Assembly:
System.Runtime.dll
Assembly:
mscorlib.dll
Assembly:
netstandard.dll
Source:
SafeHandleZeroOrMinusOneIsInvalid.cs
Source:
SafeHandleZeroOrMinusOneIsInvalid.cs
Source:
SafeHandleZeroOrMinusOneIsInvalid.cs

Fornisce una classe base per implementazioni di handle protetti Win32 in cui il valore di 0 o -1 indica un handle non valido.

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
Ereditarietà
Object
CriticalFinalizerObject
SafeHandle
SafeHandleZeroOrMinusOneIsInvalid
Derivato
Attributi
SecurityCriticalAttribute

Commenti

Tale classe deriva dalla classe System.Runtime.InteropServices.SafeHandle. Descrive il formato di un handle non valido. Ad esempio, alcuni handle usano -1 come valore di handle non valido, mentre altri usano 0. Altre derivazioni di questa classe ,ad esempio file o handle del Registro di sistema, possono essere specializzate ulteriormente. Vedere la SafeFileHandle classe per un esempio di classe che deriva da SafeHandleZeroOrMinusOneIsInvalid.

Importante

Il tipo implementa l'interfaccia IDisposable. Dopo aver utilizzato il tipo, è necessario eliminarlo direttamente o indirettamente. Per eliminare direttamente il tipo, chiamare il metodo Dispose in un blocco try/catch. Per eliminarlo indirettamente, utilizzare un costrutto di linguaggio come ad esempio using in C# o Using in Visual Basic. Per altre informazioni, vedere la sezione "Uso di un oggetto che implementa IDisposable" nell'argomento relativo all'interfaccia IDisposable.

Usare la SafeHandleZeroOrMinusOneIsInvalid classe ogni volta che è necessario eseguire il wrapping sicuro di una risorsa non gestita che non dispone di un wrapper gestito esistente.

Costruttori

SafeHandleZeroOrMinusOneIsInvalid(Boolean)

Inizializza una nuova istanza della classe SafeHandleZeroOrMinusOneIsInvalid, specificando se l'handle deve essere rilasciato in modo affidabile.

Campi

handle

Specifica l'handle di cui eseguire il wrapping.

(Ereditato da SafeHandle)

Proprietà

IsClosed

Ottiene un valore che indica se l'handle è chiuso.

(Ereditato da SafeHandle)
IsInvalid

Ottiene un valore che indica se l'handle non è valido.

Metodi

Close()

Contrassegna l'handle per il rilascio delle risorse.

(Ereditato da SafeHandle)
DangerousAddRef(Boolean)

Incrementa manualmente il numero di riferimenti nelle istanze di SafeHandle.

(Ereditato da SafeHandle)
DangerousGetHandle()

Restituisce il valore del campo handle.

(Ereditato da SafeHandle)
DangerousRelease()

Decrementa manualmente il numero di riferimenti in un'istanza di SafeHandle.

(Ereditato da SafeHandle)
Dispose()

Rilascia tutte le risorse usate dalla classe SafeHandle.

(Ereditato da SafeHandle)
Dispose(Boolean)

Rilascia le risorse non gestite usate dalla classe SafeHandle specificando se eseguire una normale operazione di eliminazione.

(Ereditato da SafeHandle)
Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.

(Ereditato da Object)
GetHashCode()

Funge da funzione hash predefinita.

(Ereditato da Object)
GetType()

Ottiene l'oggetto Type dell'istanza corrente.

(Ereditato da Object)
MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.

(Ereditato da Object)
ReleaseHandle()

Quando ne viene eseguito l'override in una classe derivata, esegue il codice necessario per liberare l'handle.

(Ereditato da SafeHandle)
SetHandle(IntPtr)

Imposta l'handle sull'handle preesistente specificato.

(Ereditato da SafeHandle)
SetHandleAsInvalid()

Contrassegna un handle come non più usato.

(Ereditato da SafeHandle)
ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.

(Ereditato da Object)

Si applica a

Vedi anche