SafeHandleZeroOrMinusOneIsInvalid Classe

Definizione

Spazio dei nomi:
Microsoft.Win32.SafeHandles
Assembly:
mscorlib.dll
Assembly:
netstandard.dll

Fornisce una classe base per le implementazioni di handle sicuri 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, handle di file o del Registro di sistema) possono essere ulteriormente specializzate. Vedere la SafeFileHandle classe per un esempio di classe che deriva da SafeHandleZeroOrMinusOneIsInvalid.

Important

Questo tipo implementa l'interfaccia IDisposable . Al termine dell'uso del tipo, è necessario eliminarlo direttamente o indirettamente. Per eliminare direttamente il tipo, chiamare il Dispose relativo metodo in un try/catch blocco. Per eliminarlo indirettamente, usare un costrutto del linguaggio, ad using esempio (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

Nome Descrizione
SafeHandleZeroOrMinusOneIsInvalid(Boolean)

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

Campi

Nome Descrizione
handle

Specifica l'handle di cui eseguire il wrapping.

(Ereditato da SafeHandle)

Proprietà

Nome Descrizione
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

Nome Descrizione
Close()

Contrassegna l'handle per il rilascio e la liberazione delle risorse.

(Ereditato da SafeHandle)
DangerousAddRef(Boolean)

Incrementa manualmente il contatore di riferimento nelle SafeHandle istanze di .

(Ereditato da SafeHandle)
DangerousGetHandle()

Restituisce il valore del handle campo.

(Ereditato da SafeHandle)
DangerousRelease()

Decrementa manualmente il contatore di riferimento in un'istanza SafeHandle di .

(Ereditato da SafeHandle)
Dispose()

Rilascia tutte le risorse usate dalla SafeHandle classe .

(Ereditato da SafeHandle)
Dispose(Boolean)

Rilascia le risorse non gestite usate dalla SafeHandle classe specificando se eseguire un'operazione dispose normale.

(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 il Type dell'istanza corrente.

(Ereditato da Object)
MemberwiseClone()

Crea una copia superficiale del Objectcorrente.

(Ereditato da Object)
ReleaseHandle()

Quando sottoposto a override in una classe derivata, esegue il codice necessario per liberare l'handle.

(Ereditato da SafeHandle)
SetHandle(IntPtr)

Imposta l'handle sull'handle esistente specificato.

(Ereditato da SafeHandle)
SetHandleAsInvalid()

Contrassegna un handle come non più utilizzato.

(Ereditato da SafeHandle)
ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.

(Ereditato da Object)

Si applica a

Vedi anche