Partilhar via


SafeHandleZeroOrMinusOneIsInvalid Classe

Definição

Fornece uma classe base para implementações do identificador de segurança Win32, em que o valor de 0 ou -1 indica um identificador invá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
Herança
SafeHandleZeroOrMinusOneIsInvalid
Derivado
Atributos

Comentários

A classe é derivada da classe System.Runtime.InteropServices.SafeHandle. Ele descreve o formato de um identificador inválido. Por exemplo, alguns identificadores usam -1 como um valor de identificador inválido, enquanto outros usam 0. Outras derivações dessa classe (por exemplo, identificadores de arquivo ou registro) podem especializar isso ainda mais. Consulte a SafeFileHandle classe para obter um exemplo de uma classe que deriva de SafeHandleZeroOrMinusOneIsInvalid.

Importante

Esse tipo implementa a interface IDisposable. Quando você terminar de usar o tipo, deverá descartá-lo direta ou indiretamente. Para descartar o tipo diretamente, chame o método Dispose dele em um bloco try/catch. Para descartá-lo indiretamente, use um constructo de linguagem como using ( em C#) ou Using (em Visual Basic). Saiba mais na seção "Como usar um objeto que implementa IDisposable" no tópico da interface IDisposable.

Use a SafeHandleZeroOrMinusOneIsInvalid classe sempre que precisar encapsular com segurança um recurso não gerenciado que não tenha um wrapper gerenciado existente.

Construtores

SafeHandleZeroOrMinusOneIsInvalid(Boolean)

Inicializa uma nova instância da classe SafeHandleZeroOrMinusOneIsInvalid, especificando se o identificador deve ser liberado de modo confiável.

Campos

handle

Especifica o identificador a ser encapsulado.

(Herdado de SafeHandle)

Propriedades

IsClosed

Obtém um valor que indica se o identificador está fechado.

(Herdado de SafeHandle)
IsInvalid

Obtém um valor que indica se o identificador é inválido.

Métodos

Close()

Marca o identificador de liberação de recursos.

(Herdado de SafeHandle)
DangerousAddRef(Boolean)

Incrementa manualmente o contador de referências em instâncias do SafeHandle.

(Herdado de SafeHandle)
DangerousGetHandle()

Retorna o valor do campo handle.

(Herdado de SafeHandle)
DangerousRelease()

Diminui manualmente o contador de referência em uma instância SafeHandle.

(Herdado de SafeHandle)
Dispose()

Libera todos os recursos usados pela classe SafeHandle.

(Herdado de SafeHandle)
Dispose(Boolean)

Libera os recursos não gerenciados usados pela classe SafeHandle que especifica se deve executar uma operação de descarte normal.

(Herdado de SafeHandle)
Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
GetHashCode()

Serve como a função de hash padrão.

(Herdado de Object)
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
MemberwiseClone()

Cria uma cópia superficial do Object atual.

(Herdado de Object)
ReleaseHandle()

Quando substituído em uma classe derivada, executa o código necessário para liberar o identificador.

(Herdado de SafeHandle)
SetHandle(IntPtr)

Define o identificador para o identificador pré-existente especificado.

(Herdado de SafeHandle)
SetHandleAsInvalid()

Marca um identificador como não mais usado.

(Herdado de SafeHandle)
ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.

(Herdado de Object)

Aplica-se a

Confira também