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.Provides a base class for Win32 safe handle implementations in which the value of either 0 or -1 indicates an invalid handle.

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.This class derives from the System.Runtime.InteropServices.SafeHandle class. Describe el formato de un identificador no válido.It describes the format of an invalid handle. Por ejemplo, algunos identificadores usan-1 como valor de identificador no válido, mientras que otros usan 0.For example, some handles use -1 as an invalid handle value, while others use 0. Otras derivaciones de esta clase (por ejemplo, identificadores de archivo o de registro) pueden especializarse más.Further derivations of this class (for example, file or registry handles) can specialize this further. Vea la SafeFileHandle clase para obtener un ejemplo de una clase que deriva de SafeHandleZeroOrMinusOneIsInvalid .See the SafeFileHandle class for an example of a class that derives from SafeHandleZeroOrMinusOneIsInvalid.

Importante

Este tipo implementa la interfaz IDisposable.This type implements the IDisposable interface. Cuando haya terminado de utilizar el tipo, debe desecharlo directa o indirectamente.When you have finished using the type, you should dispose of it either directly or indirectly. Para eliminar el tipo directamente, llame a su método Dispose en un bloque try/catch.To dispose of the type directly, call its Dispose method in a try/catch block. Para deshacerse de él indirectamente, use una construcción de lenguaje como using (en C#) o Using (en Visual Basic).To dispose of it indirectly, use a language construct such as using (in C#) or Using (in Visual Basic). Para más información, vea la sección "Uso de objetos que implementan IDisposable" en el tema de la interfaz IDisposable.For more information, see the "Using an Object that Implements IDisposable" section in the IDisposable interface topic.

Use la SafeHandleZeroOrMinusOneIsInvalid clase siempre que necesite ajustar de forma segura un recurso no administrado que no tenga un contenedor administrado existente.Use the SafeHandleZeroOrMinusOneIsInvalid class whenever you need to safely wrap an unmanaged resource that does not have an existing managed wrapper.

Constructores

SafeHandleZeroOrMinusOneIsInvalid(Boolean)

Inicializa una nueva instancia de la clase SafeHandleZeroOrMinusOneIsInvalid, especificando si el identificador se va a liberar de forma confiable.Initializes a new instance of the SafeHandleZeroOrMinusOneIsInvalid class, specifying whether the handle is to be reliably released.

Campos

handle

Especifica el identificador que se va a ajustar.Specifies the handle to be wrapped.

(Heredado de SafeHandle)

Propiedades

IsClosed

Obtiene un valor que indica si el identificador está cerrado.Gets a value indicating whether the handle is closed.

(Heredado de SafeHandle)
IsInvalid

Obtiene un valor que indica si el identificador no es válido.Gets a value that indicates whether the handle is invalid.

Métodos

Close()

Marca el identificador para soltar y liberar recursos.Marks the handle for releasing and freeing resources.

(Heredado de SafeHandle)
DangerousAddRef(Boolean)

Aumenta manualmente el recuento de referencias en instancias de SafeHandle.Manually increments the reference counter on SafeHandle instances.

(Heredado de SafeHandle)
DangerousGetHandle()

Devuelve el valor del campo handle.Returns the value of the handle field.

(Heredado de SafeHandle)
DangerousRelease()

Disminuye manualmente el recuento de referencias en una instancia de SafeHandle.Manually decrements the reference counter on a SafeHandle instance.

(Heredado de SafeHandle)
Dispose()

Libera todos los recursos que utiliza la clase SafeHandle.Releases all resources used by the SafeHandle class.

(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.Releases the unmanaged resources used by the SafeHandle class specifying whether to perform a normal dispose operation.

(Heredado de SafeHandle)
Equals(Object)

Determina si el objeto especificado es igual que el objeto actual.Determines whether the specified object is equal to the current object.

(Heredado de Object)
GetHashCode()

Sirve como la función hash predeterminada.Serves as the default hash function.

(Heredado de Object)
GetType()

Obtiene el Type de la instancia actual.Gets the Type of the current instance.

(Heredado de Object)
MemberwiseClone()

Crea una copia superficial del Object actual.Creates a shallow copy of the current Object.

(Heredado de Object)
ReleaseHandle()

Cuando se invalida en una clase derivada, ejecuta el código necesario para liberar el identificador.When overridden in a derived class, executes the code required to free the handle.

(Heredado de SafeHandle)
SetHandle(IntPtr)

Establece el identificador en el identificador preexistente.Sets the handle to the specified pre-existing handle.

(Heredado de SafeHandle)
SetHandleAsInvalid()

Marca un identificador para indicar que ya no se utiliza.Marks a handle as no longer used.

(Heredado de SafeHandle)
ToString()

Devuelve una cadena que representa el objeto actual.Returns a string that represents the current object.

(Heredado de Object)

Se aplica a

Consulte también