SafeHandleMinusOneIsInvalid Classe
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Fournit une classe de base pour les implémentations de handle sécurisé Win32 dans lesquelles la valeur de -1 indique un handle non valide.
public ref class SafeHandleMinusOneIsInvalid abstract : System::Runtime::InteropServices::SafeHandlepublic abstract class SafeHandleMinusOneIsInvalid : System.Runtime.InteropServices.SafeHandle[System.Security.SecurityCritical]
public abstract class SafeHandleMinusOneIsInvalid : System.Runtime.InteropServices.SafeHandletype SafeHandleMinusOneIsInvalid = class
inherit SafeHandle[<System.Security.SecurityCritical>]
type SafeHandleMinusOneIsInvalid = class
inherit SafeHandlePublic MustInherit Class SafeHandleMinusOneIsInvalid
Inherits SafeHandle- Héritage
- Attributs
Remarques
Cette classe dérive de la classe System.Runtime.InteropServices.SafeHandle. Il décrit le format d’un handle non valide qui utilise une valeur de -1. D’autres dérivations de cette classe (par exemple, des handles de fichier ou de Registre) peuvent se spécialiser davantage. Consultez la SafeFileHandle classe pour obtenir un exemple de classe qui dérive de SafeHandleMinusOneIsInvalid.
Warning
Ce type implémente l’interface IDisposable . Une fois que vous avez fini d’utiliser le type, vous devez le supprimer directement ou indirectement. Pour supprimer directement le type, appelez sa Dispose méthode dans un try-catch bloc. Pour la supprimer indirectement, utilisez une construction de langage telle que using (en C#) ou Using (en Visual Basic). Pour plus d’informations, consultez la section « Utilisation d’un objet implémentant IDisposable » dans la rubrique d’interface IDisposable .
Constructeurs
| Nom | Description |
|---|---|
| SafeHandleMinusOneIsInvalid(Boolean) |
Initialise une nouvelle instance de la SafeHandleMinusOneIsInvalid classe, en spécifiant si le handle doit être libéré de manière fiable. |
Champs
| Nom | Description |
|---|---|
| handle |
Spécifie le handle à wrapper. (Hérité de SafeHandle) |
Propriétés
| Nom | Description |
|---|---|
| IsClosed |
Obtient une valeur indiquant si le handle est fermé. (Hérité de SafeHandle) |
| IsInvalid |
Obtient une valeur qui indique si le handle n’est pas valide. |
Méthodes
| Nom | Description |
|---|---|
| Close() |
Marque le handle pour libérer et libérer des ressources. (Hérité de SafeHandle) |
| DangerousAddRef(Boolean) |
Incrémente manuellement le compteur de référence sur SafeHandle les instances. (Hérité de SafeHandle) |
| DangerousGetHandle() |
Retourne la valeur du handle champ. (Hérité de SafeHandle) |
| DangerousRelease() |
Décrémente manuellement le compteur de référence sur une SafeHandle instance. (Hérité de SafeHandle) |
| Dispose() |
Libère toutes les ressources utilisées par la SafeHandle classe. (Hérité de SafeHandle) |
| Dispose(Boolean) |
Libère les ressources non managées utilisées par la SafeHandle classe spécifiant s’il faut effectuer une opération de suppression normale. (Hérité de SafeHandle) |
| Equals(Object) |
Détermine si l’objet spécifié est égal à l’objet actuel. (Hérité de Object) |
| GetHashCode() |
Sert de fonction de hachage par défaut. (Hérité de Object) |
| GetType() |
Obtient la Type de l’instance actuelle. (Hérité de Object) |
| MemberwiseClone() |
Crée une copie superficielle du Objectactuel. (Hérité de Object) |
| ReleaseHandle() |
En cas de substitution dans une classe dérivée, exécute le code requis pour libérer le handle. (Hérité de SafeHandle) |
| SetHandle(IntPtr) |
Définit le handle sur le handle pré-existant spécifié. (Hérité de SafeHandle) |
| SetHandleAsInvalid() |
Marque un handle comme n’étant plus utilisé. (Hérité de SafeHandle) |
| ToString() |
Retourne une chaîne qui représente l’objet actuel. (Hérité de Object) |