SafeHandleZeroOrMinusOneIsInvalid 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 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::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- Herança
- 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) |
