SafeHandleZeroOrMinusOneIsInvalid Classe
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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::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- Ereditarietà
- Derivato
- Attributi
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) |
