SafeHandleMinusOneIsInvalid Classe
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Fornece uma classe base para implementações de identificador seguro win32 em que o valor de -1 indica um identificador inválido.
public ref class SafeHandleMinusOneIsInvalid abstract : System::Runtime::InteropServices::SafeHandlepublic abstract class SafeHandleMinusOneIsInvalid : System.Runtime.InteropServices.SafeHandle[System.Security.SecurityCritical]
public abstract class SafeHandleMinusOneIsInvalid : System.Runtime.InteropServices.SafeHandletype SafeHandleMinusOneIsInvalid = class
inherit SafeHandle[<System.Security.SecurityCritical>]
type SafeHandleMinusOneIsInvalid = class
inherit SafeHandlePublic MustInherit Class SafeHandleMinusOneIsInvalid
Inherits SafeHandle- Herança
- Atributos
Comentários
A classe é derivada da classe System.Runtime.InteropServices.SafeHandle. Ele descreve o formato de um identificador inválido que usa um valor de -1. 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 SafeHandleMinusOneIsInvalid.
Aviso
Esse tipo implementa a IDisposable interface. Quando terminar de usar esse tipo ou objeto, você deverá descartá-lo de forma direta ou indireta. 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 (no Visual Basic). Para obter mais informações, consulte a seção "Usando um objeto que implementa idisposable" no tópico da IDisposable interface.
Construtores
| Nome | Description |
|---|---|
| SafeHandleMinusOneIsInvalid(Boolean) |
Inicializa uma nova instância da SafeHandleMinusOneIsInvalid classe, especificando se o identificador deve ser liberado de forma confiável. |
Campos
| Nome | Description |
|---|---|
| handle |
Especifica o identificador a ser encapsulado. (Herdado de SafeHandle) |
Propriedades
| Nome | Description |
|---|---|
| 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
| Nome | Description |
|---|---|
| Close() |
Marca o identificador para liberar e liberar recursos. (Herdado de SafeHandle) |
| DangerousAddRef(Boolean) |
Incrementa manualmente o contador de referência em SafeHandle instâncias. (Herdado de SafeHandle) |
| DangerousGetHandle() |
Retorna o valor do handle campo. (Herdado de SafeHandle) |
| DangerousRelease() |
Diminui manualmente o contador de referência em uma SafeHandle instância. (Herdado de SafeHandle) |
| Dispose() |
Libera todos os recursos usados pela SafeHandle classe. (Herdado de SafeHandle) |
| Dispose(Boolean) |
Libera os recursos não gerenciados usados pela SafeHandle classe especificando se uma operação de descarte normal deve ser executada. (Herdado de SafeHandle) |
| Equals(Object) |
Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object) |
| GetHashCode() |
Serve como a função hash predefinida. (Herdado de Object) |
| GetType() |
Obtém o Type da instância atual. (Herdado de Object) |
| MemberwiseClone() |
Cria uma cópia superficial do Objectatual. (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) |