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 seguros win32 en las que el valor de 0 o -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. Las derivaciones adicionales de esta clase (por ejemplo, identificadores de archivo o registro) 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 IDisposable interfaz . 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 eliminarlo indirectamente, use una construcción de lenguaje como using (en C#) o Using (en Visual Basic). Para obtener más información, vea la sección "Using an Object that Implements IDisposable" (Usar un objeto que implementa IDisposable) en el tema de 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
| Nombre | Description |
|---|---|
| SafeHandleZeroOrMinusOneIsInvalid(Boolean) |
Inicializa una nueva instancia de la SafeHandleZeroOrMinusOneIsInvalid clase , especificando si el identificador se va a liberar de forma confiable. |
Campos
| Nombre | Description |
|---|---|
| handle |
Especifica el identificador que se va a encapsular. (Heredado de SafeHandle) |
Propiedades
| Nombre | Description |
|---|---|
| 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
| Nombre | Description |
|---|---|
| Close() |
Marca el identificador para liberar y liberar recursos. (Heredado de SafeHandle) |
| DangerousAddRef(Boolean) |
Incrementa manualmente el contador de referencia en SafeHandle las instancias. (Heredado de SafeHandle) |
| DangerousGetHandle() |
Devuelve el valor del handle campo. (Heredado de SafeHandle) |
| DangerousRelease() |
Reduce manualmente el contador de referencia en una SafeHandle instancia de . (Heredado de SafeHandle) |
| Dispose() |
Libera todos los recursos usados por la SafeHandle clase . (Heredado de SafeHandle) |
| Dispose(Boolean) |
Libera los recursos no administrados utilizados por la SafeHandle clase que especifica si se debe realizar una operación de eliminación normal. (Heredado de SafeHandle) |
| Equals(Object) |
Determina si el objeto especificado es igual al objeto actual. (Heredado de Object) |
| GetHashCode() |
Actúa 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 Objectactual. (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 especificado. (Heredado de SafeHandle) |
| SetHandleAsInvalid() |
Marca un identificador como ya no se usa. (Heredado de SafeHandle) |
| ToString() |
Devuelve una cadena que representa el objeto actual. (Heredado de Object) |