SafeHandleZeroOrMinusOneIsInvalid Clase
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Proporciona una clase base para implementaciones de identificadores Win32 seguros en las que el valor 0 ó -1 indica un identificador no válido.
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- Herencia
- Derivado
- Atributos
Comentarios
Esta clase deriva de la clase System.Runtime.InteropServices.SafeHandle. Describe el formato de un identificador no válido. Por ejemplo, algunos identificadores usan -1 como un valor de identificador no válido, mientras que otros usan 0. Otras derivaciones de esta clase (por ejemplo, identificadores de registro o archivo) pueden especializarse aún más. Vea la SafeFileHandle clase para obtener un ejemplo de una clase que deriva de SafeHandleZeroOrMinusOneIsInvalid.
Importante
Este tipo implementa la interfaz IDisposable. Cuando haya terminado de utilizar el tipo, debe desecharlo directa o indirectamente. Para eliminar el tipo directamente, llame a su método Dispose en un bloque try/catch. Para deshacerse de él indirectamente, use una construcción de lenguaje como using (en C#) o Using (en Visual Basic). Para más información, vea la sección "Uso de objetos que implementan IDisposable" en el tema de la interfaz IDisposable.
Use la SafeHandleZeroOrMinusOneIsInvalid clase siempre que necesite encapsular de forma segura un recurso no administrado que no tenga un contenedor administrado existente.
Constructores
| SafeHandleZeroOrMinusOneIsInvalid(Boolean) |
Inicializa una nueva instancia de la clase SafeHandleZeroOrMinusOneIsInvalid, especificando si el identificador se va a liberar de forma confiable. |
Campos
| handle |
Especifica el identificador que se va a ajustar. (Heredado de SafeHandle) |
Propiedades
| IsClosed |
Obtiene un valor que indica si el identificador está cerrado. (Heredado de SafeHandle) |
| IsInvalid |
Obtiene un valor que indica si el identificador no es válido. |
Métodos
| Close() |
Marca el identificador para soltar y liberar recursos. (Heredado de SafeHandle) |
| DangerousAddRef(Boolean) |
Aumenta manualmente el recuento de referencias en instancias de SafeHandle. (Heredado de SafeHandle) |
| DangerousGetHandle() |
Devuelve el valor del campo handle. (Heredado de SafeHandle) |
| DangerousRelease() |
Disminuye manualmente el recuento de referencias en una instancia de SafeHandle. (Heredado de SafeHandle) |
| Dispose() |
Libera todos los recursos que utiliza la clase SafeHandle. (Heredado de SafeHandle) |
| Dispose(Boolean) |
Libera los recursos no administrados usados por la clase SafeHandle especificando si se lleva a cabo una operación de eliminación normal. (Heredado de SafeHandle) |
| Equals(Object) |
Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object) |
| GetHashCode() |
Sirve como la función hash predeterminada. (Heredado de Object) |
| GetType() |
Obtiene el Type de la instancia actual. (Heredado de Object) |
| MemberwiseClone() |
Crea una copia superficial del Object actual. (Heredado de Object) |
| ReleaseHandle() |
Cuando se invalida en una clase derivada, ejecuta el código necesario para liberar el identificador. (Heredado de SafeHandle) |
| SetHandle(IntPtr) |
Establece el identificador en el identificador preexistente. (Heredado de SafeHandle) |
| SetHandleAsInvalid() |
Marca un identificador para indicar que ya no se utiliza. (Heredado de SafeHandle) |
| ToString() |
Devuelve una cadena que representa el objeto actual. (Heredado de Object) |
