SafeHandleZeroOrMinusOneIsInvalid Clase

Definición

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::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
Herencia
SafeHandleZeroOrMinusOneIsInvalid
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)

Se aplica a

Consulte también